Lokinet is an anonymous, decentralized and IP based overlay network for the internet.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 
majestrate 36925d0576
Merge pull request #1844 from majestrate/sigusr1-wire-up-thaw-2022-01-27
14 hours ago
.github Update issue templates 3 years ago
cmake match io loop event order on windows/apple to match linux. 1 month ago
contrib drop x86 for android as flutter does not support it 2 months ago
crypto fix debian sid compiler error 4 months ago
daemon handle exceptions on setup and config load without aborting 4 months ago
docs Update high-level.txt 2 months ago
external update submodule 4 months ago
include Remove obsolete bigs 5 months ago
jni add new JNI function: LokinetDaemon DumpStatus 7 months ago
llarp move constant to new header 14 hours ago
pybind match io loop event order on windows/apple to match linux. 1 month ago
test Remove broken test 2 months ago
win32-setup rebrand and bump version 10 months ago
.clang-format Config file improvements (#1397) 1 year ago
.clang-tidy Tweak clang-tidy rules 11 months ago
.dir-locals.el add emacs dir-locals 4 years ago
.dockerignore Add fail-able docker build for gcc trunk 3 years ago
.drone.jsonnet disable tests by default 3 days ago
.gitattributes Add mainnet/testnet bootstrap files into repo 5 months ago
.gitignore Add mainnet/testnet bootstrap files into repo 5 months ago
.gitmodules Remove double cpr submodule 8 months ago
.swift-version add swift version bullshit file and additional bullshittery 5 months ago
CMakeLists.txt disable tests by default 3 days ago
CMakeSettings.json Fixup MSVC build 3 years ago
CONTRIBUTING.md Update CONTRIBUTING.md 3 years ago
CONTRIBUTING_es.md Create CONTRIBUTING_es.md 3 years ago
LICENSE.txt update license preamble 2 years ago
lokinet-docker.ini got router working in docker 3 years ago
readme.md readme: point to oxen docs; mention systemctl controls 2 weeks ago
readme_es.md Add missing dep 'cppzmq' (#1764) 4 months ago
readme_ru.md Add missing dep 'cppzmq' (#1764) 4 months ago
release.md add release key files 3 years ago
release_es.md Create release_es.md 3 years ago
release_ru.md Adding Russian translation (#1447) 1 year ago

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 .

A simple demo application that is lokinet "aware" can be found here

Build Status

Installing

If you are simply looking to install Lokinet and don't want to compile it yourself the Oxen Docs Lokinet Guides for gentler instructions to get up and running.

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

Linux

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.

You can install these 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
$ 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

macOS

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.

Windows

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

windows builds are cross compiled from debian/ubuntu linux

additional build requirements:

  • nsis
  • cpack

setup:

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

building:

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

FreeBSD

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

Usage

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