Traggo¶

License: GPLv3

This guide is tested with Traggo 0.8.3 on Uberspace 8.0.76. We can't guarantee it to work with newer versions.

Traggo is an open-source, tag-based time tracking tool. It offers customizable dashboards with diagrams, a list and calendar view of the tracked time, and a sleek web interface with multiple themes and simple user management.

Note

For this guide you should be familiar with the basic concepts of:

Installation¶

Create a new directory ~/traggo and enter the directory you just created:

[isabell@moondust ~]$ mkdir ~/traggo
[isabell@moondust ~]$ cd ~/traggo

Now download the latest version, unpack the archive, and delete it afterwards:

[isabell@moondust traggo] wget https://github.com/traggo/server/releases/download/v0.8.3/traggo_0.8.3_linux_amd64.tar.gz
--2026-05-26 19:18:46--  https://github.com/traggo/server/releases/download/v0.8.3/traggo_0.8.3_linux_amd64.tar.gz
Loaded CA certificate '/etc/ssl/certs/ca-certificates.crt'
Resolving github.com (github.com)... 140.82.121.4
Connecting to github.com (github.com)|140.82.121.4|:443... connected.
HTTP request sent, awaiting response... 302 Found
[...]
Saving to: ‘traggo_0.8.3_linux_amd64.tar.gz’

traggo_0.8.3_linux_amd64.t 100%[========================================>]   6.69M  --.-KB/s    in 0.03s

2026-05-26 19:18:48 (263 MB/s) - ‘traggo_0.8.3_linux_amd64.tar.gz’ saved [7014851/7014851]

[isabell@moondust traggo] tar xvf traggo_0.8.3_linux_amd64.tar.gz
.env.sample
LICENSE
README.md
traggo
[isabell@moondust traggo] rm traggo_0.8.3_linux_amd64.tar.gz

Make the binary executable and create the file .env.local as a copy of the file .env.sample:

[isabell@moondust traggo] chmod +x traggo
[isabell@moondust traggo] cp .env.sample .env.local

Configuration¶

Configure Traggo¶

Adjust your .env.local as follows:

# the port the http server should use
TRAGGO_PORT=3030

# default username and password
TRAGGO_DEFAULT_USER_NAME=admin
TRAGGO_DEFAULT_USER_PASS=change_me_soon

# bcrypt password strength (higher = more secure but also slower)
TRAGGO_PASS_STRENGTH=10

# how verbose traggo/server should log (must be one of: debug, info, warn, error, fatal, panic)
TRAGGO_LOG_LEVEL=warn

# the database dialect (must be one of: sqlite3)
TRAGGO_DATABASE_DIALECT=sqlite3

# the database connection string, differs depending on the dialect
# sqlite3:  path/to/database.db
TRAGGO_DATABASE_CONNECTION=data/traggo.db

Warning

After logging in for the first time, immediately change the default password (change_me_soon) via the web interface.

Setup Systemd¶

Create a service:

[isabell@moondust ~]$ uberspace service add traggo "$HOME/traggo/traggo" --workdir "$HOME/traggo"

Setup Web Backend¶

Note

The default port for Traggo is 3030.

To make the application accessible from the outside, configure a web backend:

[isabell@moondust ~]$ uberspace web backend add / port 3030 --force
OK: Added webbackend '/' to your Asteroid
[isabell@moondust ~]$

If Traggo is running, you can now access it at https://isabell.uber.space.

Updates¶

Note

Check the update feed regularly.

To update the software, download the latest version and replace all files (LICENSE, README.md, traggo, and .env.sample). Also check if there are any changes in the .env.sample file compared to your currently used .env.local file. Then restart the service (systemctl --user restart traggo).