1
1
Fork 0
mirror of https://github.com/oxen-io/lokinet synced 2023-12-14 06:53:00 +01:00
Lokinet is an anonymous, decentralized and IP based overlay network for the internet.
Find a file
2021-04-19 06:58:35 -04:00
.github Update issue templates 2019-04-17 13:33:37 +10:00
android don't build liblokinet in android we have liblokinet-android for that 2021-04-19 06:55:36 -04:00
cmake lokinet-bootstrap native binary 2021-04-15 20:06:15 -04:00
contrib lokinet-bootstrap native binary 2021-04-15 20:06:15 -04:00
crypto redo cmake parts 2021-04-19 06:52:24 -04:00
daemon Merge remote-tracking branch 'origin/stable' into dev 2021-04-17 09:18:37 -04:00
debian add lokinet-vpn systemd service file 2020-05-29 12:37:34 -04:00
docs WIP plainquic tunnels 2021-04-19 06:57:45 -04:00
external fix link error in ngtcp2 2021-04-19 06:58:35 -04:00
include redo cmake parts 2021-04-19 06:52:24 -04:00
jni get rid of deprecated vpnio code in android 2021-04-19 06:52:24 -04:00
llarp clean up address/ip management code to use std::variant and std::optional 2021-04-19 06:58:05 -04:00
pybind clean up address/ip management code to use std::variant and std::optional 2021-04-19 06:58:05 -04:00
test remove llarp.h header references 2021-04-19 06:52:24 -04:00
win32-setup rebrand and bump version 2021-04-15 20:06:07 -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 lokinet-bootstrap native binary 2021-04-15 20:06:15 -04:00
.gitattributes Don't ignore .exe, .png, .gif 2020-03-05 19:09:27 -04:00
.gitignore Add more junk & clangd symlinks to .gitignore 2021-03-04 16:51:18 -04:00
.gitmodules Add ngtcp2 submodule 2021-04-19 06:56:26 -04:00
CMakeLists.txt redo cmake parts 2021-04-19 06:52:24 -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
CROSSCOMPILE.md move old stuff down a notch (#1377) 2020-10-07 20:09:47 -04:00
LICENSE.txt update license preamble 2020-05-17 11:27:41 -04:00
lokinet-bootstrap Fix for macos's decrepit old bash 3.x 2019-12-29 21:12:54 -04:00
lokinet-docker.ini got router working in docker 2019-04-24 02:10:21 +00:00
module.modulemap Initial swift module.modulemap file for LLARP 2018-12-15 01:23:06 +10:00
readme.md lokinet-bootstrap native binary 2021-04-15 20:06:15 -04:00
readme_es.md fixed broken documentation link 2021-01-30 02:52:43 -05:00
readme_ru.md fixed broken documentation link 2021-01-30 02:52:43 -05: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
run-lokinet.bat add run-lokinet.bat super duper simple wrapper thingydoo for windows 2018-12-21 08:11:59 -05:00
testnet_readme.md update testnet docs and add more tuneable paramters 2019-02-07 08:20:03 -05:00

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

Building

Build requirements:

  • Git
  • CMake
  • C++ 17 capable C++ compiler
  • libuv >= 1.27.0
  • libsodium >= 1.0.18
  • libcurl (for lokinet-bootstrap)
  • libunbound
  • libzmq
  • 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 a dev build you can do the following:

$ sudo apt install build-essential cmake git libcap-dev libcurl4-openssl-dev libuv1-dev libsodium-dev pkg-config
$ git clone --recursive https://github.com/loki-project/loki-network
$ cd loki-network
$ mkdir build
$ cd build
$ cmake .. -DBUILD_STATIC_DEPS=ON -DBUILD_SHARED_LIBS=OFF -DSTATIC_LINK=ON
$ make -j$(nproc)

install:

$ sudo make install

macOS

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

alternatively you can build from source, make sure you have cmake, libuv and xcode command line tools installed:

$ git clone --recursive https://github.com/loki-project/loki-network
$ cd loki-network
$ mkdir build
$ cd build
$ cmake .. -DBUILD_STATIC_DEPS=ON -DBUILD_SHARED_LIBS=OFF -DSTATIC_LINK=ON
$ make -j$(sysctl -n hw.ncpu)

install:

$ sudo make install

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 ninja-build

building:

$ git clone --recursive https://github.com/loki-project/loki-network
$ cd loki-network
$ ./contrib/windows.sh

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 --recursive https://github.com/loki-project/loki-network
$ cd loki-network
$ mkdir build
$ cd build
$ cmake ..
$ make -j$(nproc)

install:

$ sudo make install

FreeBSD

build:

$ pkg install cmake git pkgconf
$ git clone --recursive https://github.com/loki-project/loki-network
$ cd loki-network
$ mkdir build
$ cd build
$ cmake -DCMAKE_BUILD_TYPE=Release -DBUILD_SHARED_LIBS=OFF -DSTATIC_LINK=ON -DBUILD_SHARED_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 ready to use.

Create default config

to configure as client:

$ lokinet -g
$ lokinet-bootstrap

to configure as relay:

$ lokinet -r -g
$ lokinet-bootstrap

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, after you create default config:

$ 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, after you create default config:

$ sudo lokinet

Running on Windows

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