67 lines
2.2 KiB
Markdown
67 lines
2.2 KiB
Markdown
# Konduit GUI — Linux Quickstart
|
|
|
|
## 1. Download
|
|
|
|
Download the `Konduit-*-x86_64.AppImage` from the [Releases](../../releases) page.
|
|
|
|
## 2. Make it executable
|
|
|
|
```bash
|
|
chmod +x Konduit-*-x86_64.AppImage
|
|
```
|
|
|
|
## 3. Run
|
|
|
|
Double-click the AppImage in your file manager, or launch it from the terminal:
|
|
|
|
```bash
|
|
./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:
|
|
|
|
```bash
|
|
sudo setcap cap_net_admin=+ep ~/.local/share/konduit/konduit-helper
|
|
```
|
|
|
|
## 6. Autostart on login (optional)
|
|
|
|
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:
|
|
|
|
```bash
|
|
cp ~/.local/share/applications/konduit.desktop ~/.config/autostart/
|
|
```
|
|
|
|
## Troubleshooting
|
|
|
|
**AppImage won't launch** — your system may be missing FUSE. Install it:
|
|
|
|
```bash
|
|
# 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.
|