background-service.md

Running T3 Code in the Background

On a Linux host, T3 Code can run as a background service for your user. It starts when the machine boots and keeps running after you log out.

Manage the Service

Install it with the latest T3 Code release:

npx t3@latest service install

Check whether it is installed:

npx t3@latest service status

Update or repair it:

npx t3@latest service update

Stop it and remove it from startup:

npx t3@latest service uninstall

Updating restarts T3 Code briefly. Let active agent work and terminal commands finish first. If a remote update is already in progress, wait for it to finish before retrying a local update.

The systemd unit runs a small stable launcher. Exact T3 Code versions are installed separately, so a failed remote candidate can return to the previous version without rewriting the unit. The launcher snapshots the database before a remote candidate starts, so database updates roll back with the server version. An older launcher may require one local service update before this is available.

Using It with T3 Connect

T3 Connect may offer to install the service during setup so the host stays reachable after you log out. This is only an onboarding shortcut: the service and T3 Connect are managed separately.

Signing out of T3 Connect does not remove the service. Use t3 service uninstall when you no longer want T3 Code to start in the background.

The background service currently requires Linux with systemd.