Konduit GUI — Linux Quickstart

1. Download

Download the Konduit-*-x86_64.AppImage from the Releases page.

2. Make it executable

chmod +x Konduit-*-x86_64.AppImage

3. Run

Double-click the AppImage in your file manager, or launch it from the terminal:

./Konduit-*-x86_64.AppImage

No installation required. The AppImage is self-contained.

4. Load your config

Your server administrator will provide either a client.toml config file or a QR code image.

TOML config: your administrator will provide a client.toml file. Open it in a text editor and enter the server address, port, and key values into the corresponding fields in the app.
QR code: tap Scan QR code and point the camera at the QR code image, or use Import QR image to select an image file from disk.

5. Privileges

Konduit creates a TUN network device, which requires elevated network capability. The AppImage requests this automatically via a pkexec prompt on first run. If you see a password prompt, enter your user password to grant the capability.

If pkexec is not available on your system (some minimal desktop environments), grant the capability manually once:

sudo setcap cap_net_admin=+ep ~/.local/share/konduit/konduit-helper

To start Konduit automatically when you log in, enable autostart in the app: Settings → Start on login.

Alternatively, copy the provided desktop entry to your autostart directory:

cp ~/.local/share/applications/konduit.desktop ~/.config/autostart/

Troubleshooting

AppImage won't launch — your system may be missing FUSE. Install it:

# Debian / Ubuntu
sudo apt install libfuse2

# Fedora / RHEL
sudo dnf install fuse

"Failed to create TUN device" — the capability was not granted. Run the setcap command from step 5 and relaunch.

Connection fails immediately — check that the server address, port, and key values in the app match what your administrator provided. Contact your administrator if you are unsure.

Config lost on relaunch — re-enter your connection details or scan the QR code again.

2.2 KiB Raw Blame History