Empacotando o Tesseras para Debian

2026-02-16

O Tesseras agora inclui um pacote .deb para Debian e Ubuntu. Este post explica +como compilar e instalar o pacote a partir do código-fonte usando cargo-deb.

Pré-requisitos

Você precisa de uma toolchain Rust funcional e das bibliotecas de sistema +necessárias:

sudo apt install build-essential pkg-config libsqlite3-dev
+rustup toolchain install stable
+cargo install cargo-deb
+

Compilando

Clone o repositório e execute a recipe just deb:

git clone https://git.sr.ht/~ijanc/tesseras
+cd tesseras
+just deb
+

Essa recipe faz três coisas:

Compila tesd (o daemon) e tes (o CLI) em modo release com +cargo build --release
Gera completions de shell para bash, zsh e fish a partir do binário tes
Empacota tudo em um arquivo .deb com +cargo deb -p tesseras-daemon --no-build

O resultado é um arquivo .deb em target/debian/.

Instalando

sudo dpkg -i target/debian/tesseras-daemon_*.deb
+

Se houver dependências faltando, corrija com:

sudo apt install -f
+

Configuração pós-instalação

O script postinst cria automaticamente um usuário de sistema tesseras e o +diretório de dados /var/lib/tesseras. Para usar o CLI sem sudo, adicione seu +usuário ao grupo:

sudo usermod -aG tesseras $USER
+

Faça logout e login novamente, depois inicie o daemon:

sudo systemctl enable --now tesd
+

O que o pacote inclui

+ + + + + + +

Caminho	Descrição
`/usr/bin/tesd`	Daemon do nó completo
`/usr/bin/tes`	Cliente CLI
`/etc/tesseras/config.toml`	Configuração padrão (marcado como conffile)
`/lib/systemd/system/tesd.service`	Unit systemd com hardening de segurança
Completions de shell	bash, zsh e fish

Como o cargo-deb funciona

Os metadados de empacotamento ficam em crates/tesseras-daemon/Cargo.toml na +seção [package.metadata.deb]. Essa seção define:

depends — dependências em tempo de execução: libc6 e libsqlite3-0
assets — arquivos incluídos no pacote (binários, config, unit systemd, +completions de shell)
conf-files — arquivos tratados como configuração (preservados na +atualização)
maintainer-scripts — scripts postinst e postrm em +packaging/debian/scripts/
systemd-units — integração automática com systemd

O script postinst cria o usuário de sistema tesseras e o diretório de dados +na instalação. O script postrm remove o usuário, grupo e diretório de dados +apenas no purge (não na remoção simples).

Hardening do systemd

A unit tesd.service inclui diretivas de hardening de segurança:

NoNewPrivileges=true
+ProtectSystem=strict
+ProtectHome=true
+ReadWritePaths=/var/lib/tesseras
+PrivateTmp=true
+PrivateDevices=true
+ProtectKernelTunables=true
+ProtectControlGroups=true
+RestrictSUIDSGID=true
+MemoryDenyWriteExecute=true
+

O daemon roda como o usuário não-privilegiado tesseras e só pode escrever em +/var/lib/tesseras.

Deploy para um servidor remoto

O justfile inclui uma recipe deploy para enviar o .deb a um host remoto:

just deploy bootstrap1.tesseras.net
+

Isso compila o .deb, copia via scp, instala com dpkg -i e reinicia o +serviço tesd.

Atualizando

Depois de baixar novas mudanças, basta rodar just deb novamente e reinstalar:

git pull
+just deb
+sudo dpkg -i target/debian/tesseras-daemon_*.deb
+

+ +