Overview

Installation

Download the installer for your OS from toolport.app/download. The same installers and release notes are on GitHub Releases.

Packaged releases bundle the toolport-gateway binary, so there is nothing else to install.

Toolport ships as toolport in its own signed pacman repository, so updates arrive with pacman -Syu. It runs on Arch, Manjaro, EndeavourOS and Omarchy and needs GTK 4.10+ and libadwaita 1.4.

One-line installer:

curl -fsSL https://toolport.app/install.sh | bash

Or the same steps by hand:

curl -fsSL https://repo.toolport.app/toolport.gpg | sudo pacman-key --add -
sudo pacman-key --lsign-key A16BFA2E1014BD6BD718CC6E6621247E3FFA6AA7
 
printf '\n[toolport]\nServer = https://repo.toolport.app/$arch\n' | sudo tee -a /etc/pacman.conf
sudo pacman -Sy toolport

Requires Node.js and stable Rust, plus the platform dependencies in CONTRIBUTING.md.

npm ci
npm run build:gateway
npm run tauri dev

npm run tauri dev builds the app but not the separate gateway binary, so run npm run build:gateway first or clients will report the gateway as missing.

Run only the gateway, with no desktop app:

docker pull ghcr.io/btsouth/toolport-gateway:latest

The full setup is in Headless gateway and Docker.

On Linux, secrets are stored through the freedesktop Secret Service (GNOME Keyring, KWallet or similar). A session without a running keyring has nowhere to store them. See Troubleshooting.

Updated

Was this page helpful?