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
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.
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
To update Lokinet when installed with apt run the following command:
sudo apt update && sudo apt upgrade lokinet
Head over to Exit nodes or Accessing SNApps for an overview of the exciting things you can do with Lokinet up and running!
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.
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