lokinet/docs/install.md

Installing

If you are simply looking to install Lokinet and don't want to compile it yourself we provide several options for platforms to run on:

Tier 1:

• Linux
• Android
• Windows
• MacOS

Tier 2:

• FreeBSD

Currently Unsupported Platforms: (maintainers welcome)

• Apple iPhone
• Homebrew

• Insert Flavor of the Month windows package manager here

Official Builds

Windows / MacOS

You can get the latest stable release for lokinet on windows or macos from https://lokinet.org/ or check the releases page on github.

Linux

You do not have to build from source if you do not wish to, we provide apt and rpm repos.

APT repository

You can install debian packages from deb.oxen.io by adding the apt repo to your system.

$ sudo curl -so /etc/apt/trusted.gpg.d/oxen.gpg https://deb.oxen.io/pub.gpg
$ echo "deb https://deb.oxen.io $(lsb_release -sc) main" | sudo tee /etc/apt/sources.list.d/oxen.list

This apt repo is also available via lokinet at http://deb.loki

Once added you can install lokinet with:

$ sudo apt update
$ sudo apt install lokinet

When running from debian package the following steps are not needed as it is already running and ready to use. You can stop/start/restart it using systemctl start lokinet, systemctl stop lokinet, etc.

RPM

We also provide an RPM repo, see rpm.oxen.io, also available on lokinet at rpm.loki

Bleeding Edge dev builds

automated builds from dev branches for the brave or impatient can be found from our CI pipeline here. (warning: these nightly builds may or may not consume your first born child.)

Building

Build requirements:

• Git
• CMake
• C++ 17 capable C++ compiler
• libuv >= 1.27.0
• libsodium >= 1.0.18
• libssl (for lokinet-bootstrap)
• libcurl (for lokinet-bootstrap)
• libunbound
• libzmq
• cppzmq

Linux Compile

If you want to build from source:

$ sudo apt install build-essential cmake git libcap-dev pkg-config automake libtool libuv1-dev libsodium-dev libzmq3-dev libcurl4-openssl-dev libevent-dev nettle-dev libunbound-dev libssl-dev nlohmann-json3-dev
$ git clone --recursive https://github.com/oxen-io/lokinet
$ cd lokinet
$ mkdir build
$ cd build
$ cmake .. -DCMAKE_BUILD_TYPE=Release -DBUILD_SHARED_LIBS=OFF
$ make -j$(nproc)
$ sudo make install

set up the initial configs:

$ lokinet -g
$ lokinet-bootstrap

after you create default config, run it:

$ lokinet

This requires the binary to have the proper capabilities which is usually set by make install on the binary. If you have errors regarding permissions to open a new interface this can be resolved using:

$ sudo setcap cap_net_admin,cap_net_bind_service=+eip /usr/local/bin/lokinet

Arch Linux

Due to circumstances beyond our control a working PKGBUILD can be found here.

Cross Compile For Linux

current cross targets:

• aarch64-linux-gnu
• arm-linux-gnueabihf
• mips-linux-gnu
• mips64-linux-gnuabi64
• mipsel-linux-gnu
• powerpc64le-linux-gnu

install the toolchain (this one is for aarch64-linux-gnu, you can provide your own toolchain if you want)

$ sudo apt install g{cc,++}-aarch64-linux-gnu

build 1 or many cross targets:

$ ./contrib/cross.sh arch_1 arch_2 ... arch_n

Building For Windows

windows builds are cross compiled from debian/ubuntu linux

additional build requirements:

• nsis
• cpack
• rsvg-convert (librsvg2-bin package on Debian/Ubuntu)

setup:

$ sudo apt install build-essential cmake git pkg-config mingw-w64 nsis cpack automake libtool
$ sudo update-alternatives --set x86_64-w64-mingw32-gcc /usr/bin/x86_64-w64-mingw32-gcc-posix
$ sudo update-alternatives --set x86_64-w64-mingw32-g++ /usr/bin/x86_64-w64-mingw32-g++-posix

building:

$ git clone --recursive https://github.com/oxen-io/lokinet
$ cd lokinet
$ ./contrib/windows.sh

Compiling for MacOS

Source code compilation of Lokinet by end users is not supported or permitted by apple on their platforms, see this for more information.

If you find this disagreeable consider using a platform that permits compiling from source.

FreeBSD

Currently has no VPN Platform code, see issue #1513

build:

$ pkg install cmake git pkgconf
$ git clone --recursive https://github.com/oxen-io/lokinet
$ cd lokinet
$ mkdir build
$ cd build
$ cmake -DCMAKE_BUILD_TYPE=Release -DBUILD_SHARED_LIBS=OFF -DSTATIC_LINK=ON -DBUILD_STATIC_DEPS=ON ..
$ make

install (root):

# make install

Android

We have an Android APK for lokinet VPN via android VPN API.

Coming to F-Droid whenever that happens. [issue]

• source code