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-11-15 13:38:21 -04:00
.github Update issue templates 2019-04-17 13:33:37 +10:00
cmake bump libunbound static dep hashpin 2021-10-25 11:35:50 -04:00
contrib Install g++-8 on bionic 2021-10-28 13:49:37 -03:00
crypto fix debian sid compiler error 2021-10-13 08:05:12 -04:00
daemon handle exceptions on setup and config load without aborting 2021-10-06 15:36:29 -04:00
docs Update exit-setup.md 2021-09-12 11:07:10 -04:00
external update submodule 2021-09-24 16:51:03 -04:00
include Remove obsolete bigs 2021-09-02 19:19:54 -03:00
jni add new JNI function: LokinetDaemon DumpStatus 2021-06-20 05:55:33 -04:00
llarp Pump outbound context 2021-11-15 13:38:21 -04:00
pybind refactor logging to use std::source_location 2021-10-06 11:10:48 -04:00
test check for intersecting ip ranges correctly, add unit test 2021-10-22 15:53:19 -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 Fetch CI submodules in parallel 2021-10-18 13:50:43 -03: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 Remove double cpr submodule 2021-06-01 10:49:38 -03:00
.swift-version add swift version bullshit file and additional bullshittery 2021-09-02 14:17:08 -04:00
CMakeLists.txt version bump to 0.9.7 2021-10-19 15:17:42 -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.txt update license preamble 2020-05-17 11:27:41 -04:00
lokinet-docker.ini got router working in docker 2019-04-24 02:10:21 +00:00
readme.md Add missing dep 'cppzmq' (#1764) 2021-10-07 11:54:59 -04: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

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

Building

Build requirements:

  • Git
  • CMake
  • C++ 17 capable C++ compiler
  • libuv >= 1.27.0
  • libsodium >= 1.0.18
  • 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 are not on a platform supported by the debian packages or if you want to build a dev build, this is the most "portable" way to do it:

$ 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
$ git clone --recursive https://github.com/oxen-io/lokinet
$ cd lokinet
$ mkdir build
$ cd build
$ cmake .. -DBUILD_STATIC_DEPS=ON -DBUILD_SHARED_LIBS=OFF -DSTATIC_LINK=ON -DCMAKE_BUILD_TYPE=Release
$ make -j$(nproc)

If you dont want to do a static build install the dependancies and run:

$ cmake .. -DCMAKE_BUILD_TYPE=Release -DBUILD_SHARED_LIBS=OFF
$ make -j$(nproc)

install:

$ 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_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.

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

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