toxcore/INSTALL.md

178 lines
5.3 KiB
Markdown
Raw Normal View History

2013-08-01 05:06:04 +08:00
#Install Instructions
- [Installation](#installation)
- [Linux](#linux)
- [OS X](#osx)
- [Homebrew](#homebrew)
- [Non-Homebrew](#non-homebrew)
- [Windows](#windows)
<a name="installation" />
2013-07-19 04:29:59 +08:00
##Installation
2013-08-01 05:06:04 +08:00
<a name="linux" />
2013-07-19 04:29:59 +08:00
###Linux:
Build dependencies:
```bash
apt-get install build-essential libtool autotools-dev automake libconfig-dev ncurses-dev checkinstall check
```
On Fedora:
```bash
yum groupinstall "Development Tools"
yum install libtool autoconf automake libconfig-devel ncurses-devel check check-devel
```
2013-07-31 01:27:32 +08:00
Note that `libconfig-dev` should be >= 1.4.
2013-07-19 04:29:59 +08:00
You should get and install [libsodium](https://github.com/jedisct1/libsodium):
```bash
git clone git://github.com/jedisct1/libsodium.git
cd libsodium
git checkout tags/0.4.2
./autogen.sh
./configure && make check
sudo checkinstall --install --pkgname libsodium --pkgversion 0.4.2 --nodoc
2013-07-19 04:29:59 +08:00
sudo ldconfig
cd ..
2013-07-19 04:29:59 +08:00
```
Or if checkinstall is not easily available for your distribution (e.g. Fedora),
2013-08-03 19:37:15 +08:00
this will install the libs to /usr/local/lib and the headers to /usr/local/include:
```bash
git clone git://github.com/jedisct1/libsodium.git
cd libsodium
git checkout tags/0.4.2
./autogen.sh
./configure
2013-08-03 19:19:39 +08:00
make check
sudo make install
cd ..
```
2013-08-02 03:14:48 +08:00
Then clone this repo and generate makefile:
2013-07-19 04:29:59 +08:00
```bash
2013-08-02 03:14:48 +08:00
git clone git://github.com/irungentoo/ProjectTox-Core.git
cd ProjectTox-Core
autoreconf -i
./configure
2013-07-22 09:12:00 +08:00
make
make install
```
Advance configure options:
- --prefix=/where/to/install
- --with-libsodium-headers=/path/to/libsodium/include/
- --with-libsodium-libs=/path/to/sodiumtest/lib/
- --BUILD_DHT_BOOTSTRAP_DAEMON="yes"
- --BUILD_NTOX="yes"
- --BUILD_TESTS="yes"
2013-08-01 05:06:04 +08:00
<a name="osx" />
###OS X:
You need the latest XCode with the Developer Tools (Preferences -> Downloads -> Command Line Tools).
The following libraries are required along with libsodium and cmake for Mountain Lion and XCode 4.6.3 install libtool, automake and autoconf. You can download them with Homebrew, or install them manually.
There are no binaries/executables going to /bin/ or /usr/bin/ now. Everything is compiled and ran from the inside your local branch. See [Usage](#usage) below.
2013-08-01 05:06:04 +08:00
<a name="homebrew" />
2013-07-31 14:37:31 +08:00
####Homebrew:
```
brew install libtool automake autoconf libconfig libsodium check
```
Then clone this repo and generate makefile:
```bash
git clone git://github.com/irungentoo/ProjectTox-Core.git
cd ProjectTox-Core
autoreconf -i
./configure
2013-07-31 14:37:31 +08:00
make
make install
2013-07-31 14:37:31 +08:00
```
Advance configure options:
- --prefix=/where/to/install
- --with-libsodium-headers=/path/to/libsodium/include/
- --with-libsodium-libs=/path/to/sodiumtest/lib/
- --BUILD_DHT_BOOTSTRAP_DAEMON="yes"
- --BUILD_NTOX="yes"
- --BUILD_TESTS="yes"
2013-07-31 14:37:31 +08:00
2013-08-01 05:06:04 +08:00
<a name="non-homebrew" />
2013-07-31 14:37:31 +08:00
####Non-homebrew:
Grab the following packages:
* http://www.gnu.org/software/libtool/
* http://www.gnu.org/software/autoconf/
* http://www.gnu.org/software/automake/
* http://www.cmake.org/
* https://github.com/jedisct1/libsodium
* http://www.hyperrealm.com/libconfig/
* http://check.sourceforge.net/
Uncompress and install them all. Make sure to follow the README as the instructions change, but they all follow the same pattern below:
```bash
./configure
make
sudo make install
```
In your local TOX repository:
Then generate the makefile:
```bash
cd ProjectTox-Core
autoreconf -i
./configure
make
make install
```
Advance configure options:
- --prefix=/where/to/install
- --with-libsodium-headers=/path/to/libsodium/include/
- --with-libsodium-libs=/path/to/sodiumtest/lib/
- --BUILD_DHT_BOOTSTRAP_DAEMON="yes"
- --BUILD_NTOX="yes"
- --BUILD_TESTS="yes"
Do not install them from macports (or any dependencies for that matter) as they get shoved in the wrong directory
(or the wrong version gets installed) and make your life more annoying.
Another thing you may want to install is the latest gcc, this caused me a few problems as XCode from 4.3
no longer includes gcc and instead uses LLVM-GCC, a nice install guide can be found at
http://caiustheory.com/install-gcc-421-apple-build-56663-with-xcode-42
2013-08-01 05:06:04 +08:00
<a name="windows" />
2013-07-19 04:29:59 +08:00
###Windows:
You should install:
- [MinGW](http://sourceforge.net/projects/mingw/)'s C compiler
- [check] (http://check.sourceforge.net/)
2013-07-27 09:05:24 +08:00
You have to [modify your PATH environment variable](http://www.computerhope.com/issues/ch000549.htm) so that it contains MinGW's bin folder path. With default settings, the bin folder is located at `C:\MinGW\bin`, which means that you would have to append `;C:\MinGW\bin` to the PATH variable.
2013-07-19 04:29:59 +08:00
Then you should either clone this repo by using git, or just download a [zip of current Master branch](https://github.com/irungentoo/ProjectTox-Core/archive/master.zip) and extract it somewhere.
After that you should get precompiled package of libsodium from [here](https://download.libsodium.org/libsodium/releases/libsodium-win32-0.4.2.tar.gz) and extract the archive into this repo's root. That is, `sodium` folder should be along with `core`, `testing` and other folders.
2013-07-19 04:29:59 +08:00
Then clone this repo and generate makefile:
2013-07-19 04:29:59 +08:00
```cmd
git clone git://github.com/irungentoo/ProjectTox-Core.git
cd ProjectTox-Core
autoreconf -i
./configure
make
make install
```
Advance configure options:
- --prefix=/where/to/install
- --with-libsodium-headers=/path/to/libsodium/include/
- --with-libsodium-libs=/path/to/sodiumtest/lib/
- --BUILD_DHT_BOOTSTRAP_DAEMON="yes"
- --BUILD_NTOX="yes"
- --BUILD_TESTS="yes"