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
Rick V 37cf2c0bad
Revert "fix license", do the CRLF conversion at installer build time
This reverts commit 6fdbf6cb25988845ceef1c8b945a1bc93f6ee7e3.
2019-09-23 21:22:34 -05:00
.github Update issue templates 2019-04-17 13:33:37 +10:00
android fix android compile, have makefile pull in libuv for cmake on android 2019-07-24 11:25:40 -04:00
client Enable -Wextra 2018-11-07 15:31:13 +00:00
cmake fix static build 2019-09-23 21:22:31 -05:00
contrib remove old bootstrap code 2019-09-23 21:22:29 -05:00
crypto clang-format remaining code, use __asm__ for avx2 port since we 2019-09-03 08:02:35 -05:00
daemon Move logging to subdirectory 2019-09-03 20:52:27 +01:00
debian update debian stuff 2019-05-11 10:46:06 -04:00
docker prepare for 0.5.0 2019-08-29 07:45:58 -04:00
docs Adds Link-Relay Status Messages 2019-07-25 17:46:56 -04:00
include Move thread stuff to subdirectory 2019-09-03 20:52:28 +01:00
jni fix android compile, have makefile pull in libuv for cmake on android 2019-07-24 11:25:40 -04:00
libabyss Move thread stuff to subdirectory 2019-09-03 20:52:28 +01:00
llarp bump to 0.5.2 2019-09-23 21:22:29 -05:00
osx-setup Add libuv 2019-09-10 23:07:10 -07:00
test bump to 0.5.2 2019-09-23 21:22:29 -05:00
ui-win32 quote paths 2019-09-23 21:22:33 -05:00
vendor Move logging to subdirectory 2019-09-03 20:52:27 +01:00
win32-setup Revert "fix license", do the CRLF conversion at installer build time 2019-09-23 21:22:34 -05:00
.clang-format more netns code 2018-08-26 08:51:22 -04:00
.clang-tidy prepare for 0.5.0 2019-08-29 07:45:58 -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
.gitignore we grab a prebuilt bootstrap at build time 2019-09-23 21:22:25 -05:00
.gitlab-ci.yml gitlabci: actually install the package 2019-06-25 19:49:19 -07:00
.travis.yml undo travis changes 2019-09-23 21:22:28 -05:00
CMakeLists.txt Enable more sanitisers 2019-09-23 11:47:58 +01: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 update cross compiler docs 2019-07-16 10:11:05 -04:00
doc place protocol spec into public domain with CC0 2018-10-08 08:15:08 -04:00
Doxyfile basic doxygen configuration 2018-12-17 03:24:11 +10:00
LICENSE Revert "fix license", do the CRLF conversion at installer build time 2019-09-23 21:22:34 -05:00
lokinet-bootstrap Update lokinet-bootstrap 2019-09-04 09:38:47 -04:00
lokinet-docker.ini got router working in docker 2019-04-24 02:10:21 +00:00
Makefile Enable more sanitisers 2019-09-23 11:47:58 +01:00
module.modulemap Initial swift module.modulemap file for LLARP 2018-12-15 01:23:06 +10:00
motto.txt bump version and motto 2019-09-20 15:21:04 -04:00
readme.md Update readme.md to include readme_es.md link 2019-07-15 22:52:56 -05:00
readme_es.md Update readme_es.md 2019-07-16 08:25:18 -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
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 travis-ci

Usage

See the documentation on how to get started.

Also read the Public Testing Guide for installation and other helpful information.

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 as client:

$ lokinet -g
$ lokinet-bootstrap
$ lokinet

to run as relay:

$ lokinet -r -g
$ lokinet-bootstrap
$ 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 as client:

$ lokinet -g
$ lokinet-bootstrap
$ sudo lokinet

to run as relay:

$ lokinet -r -g
$ lokinet-bootstrap
$ sudo 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.

Building

Build requirements:

  • GNU Make
  • CMake
  • C++ 17 capable C++ compiler
  • gcovr (if generating test coverage with gcc)
  • libuv >= 1.27.0

Linux

build:

$ sudo apt install build-essential cmake git libcap-dev curl libuv1-dev
$ git clone https://github.com/loki-project/loki-network
$ cd loki-network
$ make 

install:

$ sudo make install

alternatively make a debian package with:

$ debuild -uc -us -b

this puts the built packages in ../

MacOS

build: make sure you have cmake and xcode command line tools installed

$ git clone https://github.com/loki-project/loki-network
$ cd loki-network
$ make -j8

install:

$ sudo make 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_RUNTIME=ON -DCMAKE_C_COMPILER=gcc -DCMAKE_CXX_COMPILER=g++ -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, then:

$ mkdir -p build; cd build
$ export COMPILER=clang # if using clang for windows
$ cmake .. -DCMAKE_BUILD_TYPE=[Debug|Release] -DSTATIC_LINK_RUNTIME=ON -DCMAKE_CROSSCOMPILING=ON -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)

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 https://github.com/loki-project/loki-network
$ cd loki-network
$ gmake -j8

install:

$ sudo make install

NetBSD (and other platforms where pkgsrc is the native package mgr)

TODO: add pkgsrc instructions

OpenBSD (uses legacy netbsd pkg manager)

build:

# pkg_add curl cmake git (optional: ninja ccache)
$ git clone https://github.com/loki-project/loki-network
$ cd loki-network
$ gmake -j8

install (root):

# gmake install

FreeBSD

build:

$ pkg install cmake git curl libuv-1.27.0
$ git clone https://github.com/loki-project/loki-network
$ cd loki-network
$ gmake -j8

install (root):

# gmake install