pocketwatch

pocketwatch

Docker app from winnicodes' Repository

Minimal self-hosted time tracking for freelancers.

Overview
Minimal self-hosted time tracking for freelancers. Start and stop a timer, edit entries, filter by client or period, and export a PDF report or CSV. Data lives in two JSON files in the mounted appdata folder - no database, no account, no telemetry, no outbound requests. The API has no authentication, so keep the container on your LAN or behind a reverse proxy that handles auth.

pocketwatch

Minimal time tracking.
Start the timer with one click. Send the PDF to the client. All data stays on your machine.

Live demo · Installation · Development

Docker Self-hosted License MIT


pocketwatch on the desktop: the running timer on the left, the history grouped by day on the right

Why pocketwatch?

  • Your data stays yours. Two JSON files on your disk. No account, no subscription, no tracking, no cloud.
  • Fast. No database, no loading spinner. Start and stop are one click. The timer continues after a reload.
  • Ready to invoice. PDF report with your name on it, or CSV for your spreadsheet.
  • Desktop and phone. Two columns on a large screen, one view at a time on a phone.
  • One container. docker compose up -d – runs on a NAS or a laptop.

[!TIP] The live demo is a single HTML file with the full app and demo data. Nothing is saved; a reload starts it again.

Features

Track – client list, most recent first; timer to the second; edit the activity while it runs; totals for today and this week; notice after 8 hours. History – search client and activity; grouped by day with a sticky day heading; long text expands with more; total of the selection in the footer.
The Track view with the client list and the Clock In button The history filtered by a search for Gutenberg
Period – Day, Week, Month or Year, with arrows to step back and forth. All shows the full history. Edit – start and end with date and time; duration updates immediately; keyboard-friendly pickers; an end before the start is rejected; delete asks first.
The history filtered to the current week with the period selector The Edit Entry dialog with date, time and duration
Export – PDF with your name and page numbers, or CSV (semicolons, BOM for Excel). Current view, a standard period or a date range; newest first; optionally times only. Settings – name for the PDF; German or English; 12 or 24 hours; sticky day heading; long-timer reminder; round times to 1–60 minutes.
The Export dialog with the PDF and CSV cards and the period selector Settings with rounding switched on and the interval control
On the phone

Below 1024 px the app shows one view at a time. Search, filter and export move into the header, table rows become cards and dialogs fill the screen. With “Add to Home Screen” pocketwatch opens without a browser bar.

The Track view on a phone The history as cards The navigation drawer The period filter on a phone
Edit on the full screen Export on the full screen Settings on a phone

Installation

The image is on the GitHub Container Registry. No build, no Node.js on the host.

docker run -d --name pocketwatch -p 8080:80 \
  -v "$(pwd)/data:/var/www/html/data" \
  ghcr.io/winnicodes/pocketwatch:latest

Open http://localhost:8080. Or put docker-compose.yaml in an empty folder and run docker compose up -d.

Pin a version tag (e.g. ghcr.io/winnicodes/pocketwatch:1.2.0) if you want to control when you update.

Update

docker compose pull && docker compose up -d
Unraid

pocketwatch is in Community Applications: Apps → search pocketwatch → Install. The defaults are correct:

Setting Default
WebUI 8080 (host) → 80 (container)
Data /mnt/user/appdata/pocketwatch → /var/www/html/data

Update via Docker → Check for Updates → Apply. PUID/PGID are not needed; the container fixes the owner of the appdata folder at start.

Without Community Applications: Docker → Add Container with repository ghcr.io/winnicodes/pocketwatch:latest and the port and path above. The image is linux/amd64.

Data and privacy

All data lives in the mounted data/ folder:

  • times.json – the time entries
  • config.json – the settings

Writes go to a temporary file that is then renamed, so an interrupted write cannot damage your data. To back up, copy the folder.

pocketwatch sends nothing and loads nothing from outside: no analytics, no external fonts, no external API.

[!WARNING] The API has no authentication. Run pocketwatch in your own LAN only. Anyone who can open the URL can read and change all entries. For outside access, use a reverse proxy with authentication or a VPN.

Upcoming features

  • Desktop client and Android app
  • Themes
  • Multiple profiles

Development

Architecture, build, project layout, tech stack and release: see docs/dev.md.

Support

Problems and feature requests: GitHub Issues. If pocketwatch saves you time, you can buy me a coffee on Ko-fi.

License

MIT

Media gallery

1 / 3

Categories

Related apps

Links

Details

Repository
ghcr.io/winnicodes/pocketwatch:latest
Last Updated2026-11-22
First Seen2026-08-10

Runtime arguments

Web UI
http://[IP]:[PORT:80]
Network
bridge
Shell
sh
Privileged
false

Template configuration

WebUIPorttcp

HTTP port for the WebUI.

Target
80
Default
8080
DataPathrw

times.json and config.json live here. Back this folder up.

Target
/var/www/html/data
Default
/mnt/user/appdata/pocketwatch