mirror of
https://github.com/oxen-io/lokinet.git
synced 2024-11-15 12:13:24 +00:00
97 lines
2.5 KiB
Markdown
97 lines
2.5 KiB
Markdown
# LokiNet
|
|
|
|
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](docs/high-level.txt)
|
|
|
|
And you can read the LLARP protocol specification [here](docs/proto_v0.txt)
|
|
|
|
|
|
|
|
## Building
|
|
|
|
Build requirements:
|
|
|
|
* GNU Make
|
|
* CMake
|
|
* C++ 17 capable C++ compiler
|
|
* rapidjson (if enabling jsonrpc server)
|
|
* gcovr (if generating test coverage with gcc)
|
|
|
|
### Linux
|
|
|
|
build:
|
|
|
|
$ sudo apt install build-essential cmake git libcap-dev wget rapidjson-dev
|
|
$ git clone https://github.com/loki-project/loki-network
|
|
$ cd loki-network
|
|
$ make -j8
|
|
|
|
install:
|
|
|
|
$ sudo make install
|
|
|
|
|
|
### FreeBSD
|
|
|
|
build:
|
|
|
|
$ pkg install wget cmake git
|
|
$ git clone https://github.com/loki-project/loki-network
|
|
$ cd loki-network
|
|
$ gmake -j8
|
|
|
|
install (root):
|
|
|
|
# gmake 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=ON -DCMAKE_C_COMPILER=gcc -DCMAKE_CXX_COMPILER=g++ -DDNS_PORT=53 -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](https://sourceforge.net/p/mingw-w64/wiki2/Cross%20Win32%20and%20Win64%20compiler/), then:
|
|
|
|
$ mkdir -p build; cd build
|
|
$ export COMPILER=clang # if using clang for windows
|
|
$ cmake .. -DCMAKE_BUILD_TYPE=[Debug|Release] -DSTATIC_LINK=ON -DCMAKE_CROSSCOMPILING=ON -DDNS_PORT=53 -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)
|
|
|
|
## Running on Linux/UNIX/BSD
|
|
|
|
**DO NOT RUN AS ROOT**, run as normal user.
|
|
|
|
to run as client:
|
|
|
|
$ lokinet -g
|
|
$ lokinet-bootstrap
|
|
$ lokinet
|
|
|
|
to run as relay:
|
|
|
|
$ lokinet -r -g
|
|
$ lokinet-bootstrap
|
|
$ 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.
|
|
|
|
|
|
## Usage
|
|
|
|
see the [documentation](https://loki-project.github.io/loki-docs/Lokinet/LokinetOverview/) on how to get started.
|