🐧Installing on Linux (CLI)

Initial setup

1. Computer Preparation

Begin by updating your package lists. The below command downloads package lists from your repositories and "updates" them to get information on the newest versions of packages and their dependencies. It will do this for all repositories and PPAs.

Run the following command:

sudo apt-get update

You'll notice a bunch of package lists were downloaded. Once this is complete, run the below command to fetch new versions of any packages we currently have installed on the system:

sudo apt-get upgrade

You'll be prompted to authorise the use of disk space. Type y and press Enter to authorise.

If you do not have curl installed on your computer, now is also a good time to install it, as we will use it later:

sudo apt install curl

2. Installation

You only need to do this step the first time you want to set up the Lokinet repository. After you've done it once, the repository will automatically update whenever you fetch new system updates.

This first command installs the public key used to sign official Lokinet binaries.

sudo curl -so /etc/apt/trusted.gpg.d/oxen.gpg https://deb.oxen.io/pub.gpg

The next command tells apt where to find the packages:

echo "deb https://deb.oxen.io $(lsb_release -sc) main" | sudo tee /etc/apt/sources.list.d/oxen.list

Note: if you're running Linux Mint and get an error with this command, check out Troubleshooting.

Then resync your package repositories with:

sudo apt update

Now install Lokinet:

sudo apt install lokinet

Congratulations, Lokinet is now installed and running in the background.

Starting and stopping Lokinet

By default, lokinet will be running in the background on boot.

You can disable lokinet from starting on boot with:

sudo systemctl disable --now lokinet

You can re-enable lokinet to run on boot with:

sudo systemctl enable --now lokinet

You can stop the lokinet service with:

sudo systemctl stop lokinet

You can use stop, start or restart to start and stop lokinet using the command above replacing stop with start or restart

Updating Lokinet

To update Lokinet when installed with apt run the following command:

sudo apt update && sudo apt upgrade lokinet

Using Lokinet

Head over to Exit nodes or Accessing SNApps for an overview of the exciting things you can do with Lokinet up and running!

CLI installation troubleshooting

If lokinet gets "stuck" trying to connect to the network, back up any persisting private keys for .loki and....

  • stop the lokinet service

  • remove /var/lib/lokinet/profiles.dat

  • start the lokinet service

this will remove the client's inferred network state that it slowly generates over time, thus will start retrying nodes it thought were dead before.

Linux Mint does not work with (lsb-release)

It has been reported that Linux Mint users may need to use the following command instead of the second command in 2. Installation:

echo "deb https://deb.oxen.io jammy main" | sudo tee /etc/apt/sources.list.d/oxen.list

Last updated