Skip to content
Lokinet is an anonymous, decentralized and IP based overlay network for the internet.
C++ C CMake JavaScript Python C# Other
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Update issue templates Apr 17, 2019
android pull in libsodium if local version sucks Oct 31, 2019
client Enable -Wextra Nov 7, 2018
cmake use proper cmake call Jan 7, 2020
contrib contrib/testnet: fix up testnet config generator to make super centra… Jan 14, 2020
crypto Enable cpu detection on amd64 Jan 9, 2020
daemon daemon don't override the existing CURL Dec 23, 2019
debian update debian stuff May 11, 2019
docker more travis fixes Dec 10, 2019
docs Adds Link-Relay Status Messages Jul 25, 2019
include why was this there Dec 22, 2019
jni remove unused file Oct 9, 2019
libabyss remove abyss-exe Dec 16, 2019
llarp bump version for 0.6.4 Jan 19, 2020
osx-setup Merge pull request #885 from loki-project/neuroscr-macos-installer-ge… Oct 30, 2019
test happy new year Jan 6, 2020
ui-ios Remove FS_LIB conditionals Dec 12, 2019
ui-macos Improvements to app workflow Sep 30, 2019
ui-win32 happy new year Jan 6, 2020
vendor Xenial compatibility Dec 19, 2019
win32-setup happy new year Jan 6, 2020
.clang-format more netns code Aug 26, 2018
.clang-tidy prepare for 0.5.0 Aug 29, 2019
.dir-locals.el add emacs dir-locals May 21, 2018
.dockerignore Add fail-able docker build for gcc trunk Aug 2, 2019
.gitignore Merge branch 'dev' into dev Sep 25, 2019
.gitlab-ci.yml disable failing gitlab ci Jan 2, 2020
.travis.yml allow fail of docker build because docker is fail Jan 2, 2020
CMakeLists.txt Simplify CRYPTO_FLAGS logic, remove RYZEN_HACK Jan 7, 2020
CMakeSettings.json Fixup MSVC build May 15, 2019
CONTRIBUTING.md Update CONTRIBUTING.md Jul 20, 2019
CONTRIBUTING_es.md Create CONTRIBUTING_es.md Jul 20, 2019
CROSSCOMPILE.md update cross compiler docs Jul 16, 2019
Doxyfile basic doxygen configuration Dec 16, 2018
LICENSE happy new year Jan 6, 2020
Makefile add hashpinned curl tarball for static build Jan 7, 2020
doc place protocol spec into public domain with CC0 Oct 8, 2018
lokinet-bootstrap Fix for macos's decrepit old bash 3.x Dec 30, 2019
lokinet-docker.ini got router working in docker Apr 24, 2019
module.modulemap Initial swift module.modulemap file for LLARP Dec 14, 2018
motto.txt version bump with intentional grammar troll motto for science related… Dec 26, 2019
readme.md fixups for review Jan 7, 2020
readme_es.md finishing touches Oct 29, 2019
release.md add release key files Jun 12, 2019
release_es.md Create release_es.md Jul 20, 2019
run-lokinet.bat add run-lokinet.bat super duper simple wrapper thingydoo for windows Dec 21, 2018
testnet_readme.md update testnet docs and add more tuneable paramters Feb 7, 2019

readme.md

Lokinet

Español

Lokinet is the reference implementation of LLARP (low latency anonymous routing protocol), a layer 3 onion routing protocol.

You can learn more about the high level design of LLARP here

And you can read the LLARP protocol specification here

You can view documentation on how to get started here .

build status travis-ci

Usage

See the documentation on how to get started.

Also read the Public Testing Guide for installation and other helpful information.

Running on Linux

DO NOT RUN AS ROOT, run as normal user. This requires the binary to have the proper setcaps set by make install on the binary.

to run as client:

$ lokinet -g
$ lokinet-bootstrap
$ lokinet

to run as relay:

$ lokinet -r -g
$ lokinet-bootstrap
$ lokinet

Running on MacOS/UNIX/BSD

YOU HAVE TO RUN AS ROOT, run using sudo. Elevated privileges are needed to create the virtual tunnel interface.

The MacOS installer places the normal binaries (lokinet and lokinet-bootstrap) in /usr/local/bin which should be in your path, so you can easily use the binaries from your terminal. The installer also nukes your previous config and keys and sets up a fresh config and downloads the latest bootstrap seed.

to run as client:

$ lokinet -g
$ lokinet-bootstrap
$ sudo lokinet

to run as relay:

$ lokinet -r -g
$ lokinet-bootstrap
$ sudo lokinet

Running on Windows

DO NOT RUN AS ELEVATED USER, run as normal user.

to run as client, run the run-lokinet.bat batch file as your normal user.

Building

Build requirements:

  • GNU Make
  • CMake
  • C++ 14 capable C++ compiler
  • gcovr (if generating test coverage with gcc)
  • libuv >= 1.27.0
  • libsodium >= 1.0.17
  • libcurl

Linux

build:

$ sudo apt install build-essential cmake git libcap-dev curl libuv1-dev libsodium-dev libcurl4-openssl-dev pkg-config
$ git clone https://github.com/loki-project/loki-network
$ cd loki-network
$ make 

install:

$ sudo make install

alternatively make a debian package with:

$ debuild -uc -us -b

this puts the built packages in ../

Static Linux

static native optimized:

$ make static STATIC_LINK=ON

cross compile fully static armhf (rpi 2 and up)

$ make static STATIC_LINK=ON DOWNLOAD_SODIUM=ON TOOLCHAIN=contrib/cross/armhf.toolchain.cmake

MacOS

build: make sure you have cmake, libuv and xcode command line tools installed

$ git clone https://github.com/loki-project/loki-network
$ cd loki-network
$ make -j8

install:

$ sudo make install

Windows

build (where $ARCH is your platform - i686 or x86_64):

$ pacman -Sy base-devel mingw-w64-$ARCH-toolchain git libtool autoconf mingw-w64-$ARCH-cmake
$ git clone https://github.com/loki-project/loki-network.git
$ cd loki-network
$ mkdir -p build; cd build
$ cmake .. -DCMAKE_BUILD_TYPE=[Debug|Release] -DSTATIC_LINK_RUNTIME=ON -DCMAKE_C_COMPILER=gcc -DCMAKE_CXX_COMPILER=g++ -G 'Unix Makefiles'

install (elevated) to $PROGRAMFILES/lokinet or $ProgramFiles(x86)/lokinet:

$ make install

if cross-compiling, install mingw-w64 from your distro's package manager, or build from source, then:

$ mkdir -p build; cd build
$ export COMPILER=clang # if using clang for windows
$ cmake .. -DCMAKE_BUILD_TYPE=[Debug|Release] -DSTATIC_LINK_RUNTIME=ON -DCMAKE_CROSSCOMPILING=ON -DCMAKE_TOOLCHAIN_FILE=../contrib/cross/mingw[32].cmake

this will create a static binary that can be installed anywhere, with no other dependency other than libc (minimum v6.1)

Solaris 2.10+

NOTE: Oracle Solaris users need to download/compile the TAP driver from http://www.whiteboard.ne.jp/~admin2/tuntap/

The generated binaries may work on Solaris 2.10 or earlier, you're on your own. (Recommended: -static-libstdc++ -static-libgcc, and the TAP driver if not already installed on the target system.)

Building on a v2.10 or earlier system is unsupported, and may not even work; recent GCC releases have progressively dropped support for older system releases.

build:

$ sudo pkg install build-essential gcc8 wget tuntap cmake (optional: ninja ccache - from omnios extra) (OmniOS CE)
$ sudo pkg install base-developer-utilities developer-gnu developer-studio-utilities gcc-7 wget cmake (Oracle Solaris, see note)
$ sudo pkg install build-essential wget gcc-8 documentation/tuntap header-tun tun (optional: ninja ccache) (all other SunOS)
$ git clone https://github.com/loki-project/loki-network
$ cd loki-network
$ gmake -j8

install:

$ sudo make install

NetBSD (and other platforms where pkgsrc is the native package mgr)

TODO: add pkgsrc instructions

OpenBSD (uses legacy netbsd pkg manager)

build:

# pkg_add curl cmake git (optional: ninja ccache)
$ git clone https://github.com/loki-project/loki-network
$ cd loki-network
$ gmake -j8

install (root):

# gmake install

FreeBSD

build:

$ pkg install cmake git curl libuv libsodium pkgconf
$ git clone https://github.com/loki-project/loki-network
$ cd loki-network
$ mkdir build
$ cmake -DCMAKE_BUILD_TYPE=Release ..
$ make

install (root):

# make install
You can’t perform that action at this time.