Lokinet is an anonymous, decentralized and IP based overlay network for the internet.
Go to file
Jeff 0fe716e1dd more docs 2022-02-19 16:08:09 -05:00
.github Update issue templates 2019-04-17 13:33:37 +10:00
cmake Crank oxen-mq to (1.2.)11; switch to oxen-encoding 2022-02-17 16:30:17 -04:00
contrib include mkdocs.yml in ci artifacts for docs 2022-02-17 18:01:53 -05:00
crypto fix debian sid compiler error 2021-10-13 08:05:12 -04:00
daemon Merge pull request #1748 from majestrate/liblokinet-udp-api-2021-09-19 2022-02-06 13:19:08 -05:00
docs more docs 2022-02-19 16:08:09 -05:00
external Crank oxen-mq to (1.2.)11; switch to oxen-encoding 2022-02-17 16:30:17 -04:00
include docstring update 2022-01-31 10:53:48 -05:00
jni add new JNI function: LokinetDaemon DumpStatus 2021-06-20 05:55:33 -04:00
llarp make comments with colins in them not have them in it 2022-02-17 18:01:53 -05:00
pybind Crank oxen-mq to (1.2.)11; switch to oxen-encoding 2022-02-17 16:30:17 -04:00
test Remove broken test 2021-11-15 16:20:07 -04:00
win32-setup rebrand and bump version 2021-04-14 12:55:52 -04:00
.clang-format Config file improvements (#1397) 2020-10-07 18:22:58 -04:00
.clang-tidy Tweak clang-tidy rules 2021-03-04 16:51:18 -04:00
.dir-locals.el add emacs dir-locals 2018-05-21 10:52:30 -04:00
.dockerignore Add fail-able docker build for gcc trunk 2019-08-02 10:28:09 +01:00
.drone.jsonnet move documentation builder closer to the top of the ci jobs 2022-02-17 18:01:53 -05:00
.gitattributes Add mainnet/testnet bootstrap files into repo 2021-09-10 19:38:32 -03:00
.gitignore Add mainnet/testnet bootstrap files into repo 2021-09-10 19:38:32 -03:00
.gitmodules Crank oxen-mq to (1.2.)11; switch to oxen-encoding 2022-02-17 16:30:17 -04:00
.swift-version add swift version bullshit file and additional bullshittery 2021-09-02 14:17:08 -04:00
CMakeLists.txt Crank oxen-mq to (1.2.)11; switch to oxen-encoding 2022-02-17 16:30:17 -04:00
CMakeSettings.json Fixup MSVC build 2019-05-15 23:03:24 +01:00
CONTRIBUTING.md Update CONTRIBUTING.md 2019-07-19 22:08:47 -05:00
CONTRIBUTING_es.md Create CONTRIBUTING_es.md 2019-07-19 22:04:50 -05:00
LICENSE make it so github sees the repo is gpl3 2022-01-28 11:20:22 -05:00
lokinet-docker.ini got router working in docker 2019-04-24 02:10:21 +00:00
readme.md spruce up README more 2022-02-12 19:05:34 -05:00
readme_es.md Add missing dep 'cppzmq' (#1764) 2021-10-07 11:54:59 -04:00
readme_ru.md Add missing dep 'cppzmq' (#1764) 2021-10-07 11:54:59 -04:00
release.md add release key files 2019-06-12 19:31:12 -04:00
release_es.md Create release_es.md 2019-07-19 21:44:17 -05:00
release_ru.md Adding Russian translation (#1447) 2020-11-03 09:11:18 -05:00



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

Build Status


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:

Tier 2:

Currently Unsupproted Platforms: (maintainers welcome)

  • Apple iPhone
  • Homebrew
  • Insert Flavor of the Month windows package manager here


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
  • sqlite3


You do not have to build from source if you are on debian or ubuntu as we have apt repositories with pre-built lokinet packages on deb.oxen.io or rpm.oxen.io.

You can install debian packages using:

$ 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
$ sudo apt update
$ sudo apt install lokinet

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 libsqlite3-dev libssl-dev nlohmann-json3-dev
$ git clone --recursive https://github.com/oxen-io/lokinet
$ cd lokinet
$ mkdir build
$ cd build
$ make -j$(nproc)
$ sudo make install

Cross Compile For Linux

install the toolchain for $arch this example is aarch64

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

build 1 or many cross targets:

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


Lokinet is will be available on the Apple App store.

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.


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

nightly builds for the brave or impatient can be found from our CI pipeline here

Building For Windows

windows builds are cross compiled from debian/ubuntu linux

additional build requirements:

  • nsis
  • cpack


$ sudo apt install build-essential cmake git pkg-config mingw-w64 nsis cpack automake libtool


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


Currently has no VPN Platform code, see #1513


$ pkg install cmake git pkgconf
$ git clone --recursive https://github.com/oxen-io/lokinet
$ cd lokinet
$ mkdir build
$ cd build
$ make

install (root):

# make install


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

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


Debian / Ubuntu packages

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.

Running on Linux (without debs)

DO NOT RUN AS ROOT, run as normal user.

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


This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

Copyright © 2018-2022 The Oxen Project
Copyright © 2018-2022 Jeff Becker
Copyright © 2018-2020 Rick V. (Historical Windows NT port and portions)