Skip to main content

Installing Netsody on Linux

This guide explains how to install Netsody on Linux. Netsody consists of two components:

  • Netsody agent: background service
  • Netsody UI: desktop application to manage the agent

You can install either the agent alone (headless setup) or both components.

Supported Distributions

We currently provide:

  • .deb packages for:
    • Ubuntu 22.04 (Jammy) and newer.
    • Debian 12 (Bookworm) and newer.
  • .rpm packages for:
    • Fedora 41 and newer (agent only, x86_64 only).

If you need to install Netsody on other platforms, you can contact us for assistance.

Installing the Netsody Agent​

Step 1: Download the Agent Package​

Choose your system architecture:

curl -LO https://download.netsody.io/binaries/0.1.0/linux-amd64/netsody_0.1.0_amd64.deb

Step 2: Install the Package​

sudo dpkg -i netsody_0.1.0_amd64.deb

After this, the agent runs as a background service.

Step 3: Configure authentication​

Copy the authentication token to the current user's directory:

mkdir -p ~/.netsody
su -c "cat /etc/netsody/auth.token" > ~/.netsody/auth.token
chmod 600 ~/.netsody/auth.token

Installing the Netsody UI (Desktop only)​

Step 1: Download the UI Package​

📦 netsody-ui_0.1.0_amd64.deb (UI is currently only available for x86_64)

Step 2: Install the Package​

sudo dpkg -i netsody-ui_0.1.0_amd64.deb

Step 3: Start the Netsody UI​

  • Open your application launcher, search for "Netsody UI", and launch it.
  • The UI icon will appear in your system tray.
First Startup Delay

On first startup, the UI may take a few seconds to connect to the agent while it completes the proof-of-work process.

Once connected, the public key of your device is displayed.

Linux system tray showing the Netsody UI application

Figure 1: Linux system tray showing the Netsody UI application

Copy Public Key

You can copy your public key by clicking on it in the Netsody UI. Alternatively, run netsody status in your terminal to display it.

Next Step​