Debian / Ubuntu¶
Install Trident on Debian, Ubuntu, and derivatives (Linux Mint, Pop!_OS, Kali, Raspberry Pi OS) using APT.
Tested Distributions
This installation method is tested end-to-end on Debian 12 (Bookworm) and Ubuntu 24.04 (Noble Numbat) using automated integration tests that verify binaries, configuration, systemd service, caching behavior, and graceful shutdown.
Automatic Setup¶
The repository setup script handles everything:
Then install:
Manual Setup¶
If you prefer to configure the repository manually:
1. Install prerequisites¶
2. Import the GPG signing key¶
sudo mkdir -p /usr/share/keyrings
curl -fsSL https://pkg.trident-cache.com/gpg.key \
| sudo gpg --dearmor -o /usr/share/keyrings/trident-archive-keyring.gpg
3. Add the repository¶
echo "deb [signed-by=/usr/share/keyrings/trident-archive-keyring.gpg] https://pkg.trident-cache.com/apt stable main" \
| sudo tee /etc/apt/sources.list.d/trident.list
4. Install¶
What Gets Installed¶
The package installs and configures the following:
| Component | Path |
|---|---|
| Main binary | /usr/bin/trident |
| CLI tool | /usr/bin/trident-cli |
| Default config | /etc/trident/config.toml |
| Systemd service | /lib/systemd/system/trident.service |
| Cache directory | /var/lib/trident/ (owned by trident:trident) |
| Log directory | /var/log/trident/ (owned by trident:trident) |
A trident system user and group are created automatically by the package's preinstall script.
Verify Installation¶
Check that the systemd service file is in place:
Next Steps¶
- Configuration — edit
/etc/trident/config.toml - Service Management — start and enable the systemd service