mirror of https://github.com/oxen-io/lokinet
You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
67 lines
1.3 KiB
Markdown
67 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](docs/high-level.txt)
|
|
|
|
And you can read the LLARP protocol specification [here](docs/proto_v0.txt)
|
|
|
|
![build status](https://gitlab.com/lokiproject/loki-network/badges/master/pipeline.svg "build status")
|
|
|
|
## Building
|
|
|
|
Build requirements:
|
|
|
|
* GNU Make
|
|
* CMake
|
|
* C++ 17 capable C++ compiler
|
|
* rapidjson (if enabling jsonrpc server)
|
|
|
|
### 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
|
|
|
|
|
|
## Running
|
|
|
|
**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
|
|
|
|
## Usage
|
|
|
|
see the [documentation](https://loki-project.github.io/loki-docs/Lokinet/LokinetOverview/) on how to get started.
|