Install on Debian and Ubuntu

This page adds the Tilde apt repository to Debian and Ubuntu and installs Tilde with apt. Run steps 1 to 3 once; after that apt keeps Tilde up to date with the rest of the system.

1. Add the key

If curl is not installed, run sudo apt install curl first.

sudo curl https://codeberg.org/api/packages/squidd/debian/repository.key -o /etc/apt/keyrings/forgejo-squidd.asc

2. Add the source

echo "deb [signed-by=/etc/apt/keyrings/forgejo-squidd.asc] https://codeberg.org/api/packages/squidd/debian stable main" | sudo tee /etc/apt/sources.list.d/tilde.list

stable is the name of a distribution in the registry, not of your system. It holds the releases.

3. Install

sudo apt update && sudo apt install tilde-all

There are three packages:

Package	What it installs	Program
tilde-all	Both programs. It holds no program of its own, only the two dependencies at the same version.	tcli and tt
tilde-cli	The command line tool.	tcli
tilde-tui	The terminal interface.	tt

To install one program, give its package to apt install instead of tilde-all. Next, write a first configuration.

4. Update

sudo apt update && sudo apt upgrade

5. Nightly

The registry has a second distribution, nightly, with a build of the development branch, develop, for every night. Use the same two lines with nightly in place of stable, and use one distribution at a time. The version, the retention and the signature are on Nightly builds.

6. Check a download by hand

Packages from apt need no check: apt verifies them with the key of step 1. A .deb or an archive that you download from the release page is checked with the signed SHA256SUMS, as Check a download shows.

7. Notes

• The packages are for amd64 and arm64. The page is for Debian and Ubuntu with apt; for any other system use an archive.
• The packages recommend gnupg, because the OpenPGP commands run gpg.
• A pre-release such as v0.5.0-rc.1 is on the release page and never in the registry.
• tcli --version and tt --version print the installed version and nothing else.

Next: First run writes a first config.toml, and the tutorial tries tt with made-up mail.