LogoLogo
DownloadsBlock ExplorerSupport
  • πŸ’‘Introduction to Oxen
  • πŸ“Downloads
  • πŸ†˜Support
  • About the Oxen blockchain
    • πŸ—ΊοΈOverview
    • πŸ“ŠToken economics
      • πŸ”₯Token burning
    • πŸ–₯️Oxen Service Nodes
    • πŸ’“Pulse: PoS on Oxen
      • 🀿Pulse: Deep dive
    • πŸ‘οΈBlink: Instant transactions
  • Using the Oxen Blockchain
    • πŸ“Overview
    • πŸ’°Oxen Wallet & Guides
      • Preparing for GUI Wallet setup (Windows)
      • GUI Wallet setup
      • GUI Wallet Quickstart
      • GUI Wallet Staking
      • Oxen Mobile Wallet Quickstart
      • Mobile Wallet Staking Guide
      • Exporting a CSV of your wallet transaction history
      • CLI Wallet setup (macOS)
      • Oxen Ledger Wallet setup: GUI Wallet
      • Oxen Ledger Wallet setup: CLI Wallet
      • CLI Wallet commands
      • Restoring an Oxen CLI Wallet from seed
      • Restoring an Oxen CLI Wallet from keys
    • πŸ–₯️Service Node guides
      • 🏎️Express service node setup guide
      • 🍺Full service node setup guide
      • πŸ’ΈStaking to a shared Oxen Service Node
      • πŸ›‘Service Node deregistration
      • πŸ› οΈService node tools and upkeep
    • ⛴️Migrating to the new Session Network
      • βœ…Migration Checklist
      • ❓Migration FAQ
      • πŸ”—Connecting to an Arbitrum One RPC Endpoint
      • πŸ”€How to set up an oxend L2 proxy
    • πŸ”‘Using Oxen Name System (ONS)
    • πŸ€“Advanced
      • Service node πŸ“ž RPC calls
      • Daemon πŸ“ž RPC calls
      • Wallet πŸ“ž RPC calls
  • Products built on Oxen
    • πŸ”’Session
      • πŸ“šGuides
        • 🐧Installing on Linux (Debian based distros)
        • πŸ—£οΈSession Open Group Server Setup
          • πŸ“—Read Only Room Setup
      • πŸ”€Oxen Name Service for Session
      • πŸ—οΈNetwork infrastructure
      • πŸ“¨Message routing
      • πŸ“ŽAttachments
    • 🌐Lokinet
      • πŸ“šGuides
        • 🐧Installing on Linux (CLI)
        • 🐧Installing on Linux (GUI)
        • 🐧Linux troubleshooting
        • 🍎Installing on macOS
        • πŸͺŸInstalling on Windows
        • 🍎macOS troubleshooting
        • πŸ“žRun a secure Mumble server over Lokinet
      • πŸ‘‹Exit nodes
      • πŸ§‘β€πŸ’»πŸ§‘πŸ’» SNApps
        • πŸš€Accessing SNApps
        • πŸ–₯️Hosting SNApps
        • πŸ—ΊοΈDomain Names For Lokinet (ONS)
        • ⏺️Configuring SRV Records
Powered by GitBook
On this page
  • Initial setup
  • Starting and stopping Lokinet
  • Updating Lokinet
  • Using Lokinet
  • CLI installation troubleshooting

Was this helpful?

Edit on GitHub
Export as PDF
  1. Products built on Oxen
  2. Lokinet
  3. Guides

Installing on Linux (CLI)

PreviousGuidesNextInstalling on Linux (GUI)

Last updated 2 years ago

Was this helpful?

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 .

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

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)

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

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

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

🌐
πŸ“š
🐧
Exit nodes
Accessing SNApps
Troubleshooting
2. Installation