mirror of
https://github.com/oxen-io/lokinet.git
synced 2024-11-11 07:10:36 +00:00
57 lines
1.3 KiB
Markdown
57 lines
1.3 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](doc/high-level.txt)
|
|
|
|
And you can read the LLARP protocol specification [here](doc/proto_v0.txt)
|
|
|
|
|
|
## Building
|
|
|
|
![build status](https://gitlab.com/lokiproject/loki-network/badges/master/pipeline.svg "build status")
|
|
|
|
|
|
If you don't have libsodium 1.0.16 or higher use the [lokinet builder](https://github.com/loki-project/lokinet-builder) repo.
|
|
|
|
Otherwise:
|
|
|
|
$ sudo apt install git libcap-dev build-essential ninja-build cmake libsodium-dev
|
|
$ git clone https://github.com/loki-project/loki-network
|
|
$ cd loki-network
|
|
$ make
|
|
|
|
## Usage
|
|
|
|
### Windows
|
|
|
|
Windows only supports client mode so you run `lokinet.exe` and that's it.
|
|
|
|
### Linux
|
|
|
|
Client mode:
|
|
|
|
For simple testing do:
|
|
|
|
$ lokinet
|
|
|
|
On systemd based distros you can persist it in the background:
|
|
|
|
# systemctl enable --now lokinet-client
|
|
|
|
|
|
Relay mode:
|
|
|
|
you can participate as a relay node trivially (for now).
|
|
|
|
On systemd based linux distros do:
|
|
|
|
# systemctl enable --now lokinet-relay
|
|
|
|
Alternatively:
|
|
|
|
# mkdir /usr/local/lokinet
|
|
# cd /usr/local/lokinet
|
|
# lokinet -g /usr/local/lokinet/daemon.ini
|
|
# lokinet /usr/local/lokinet/daemon.ini
|