Files
upstream-aw-server/README.md
upstream-mirror 07fb811788
Some checks failed
Build / Test on ubuntu-latest (push) Successful in 3m6s
Lint / lint (push) Successful in 22s
Build / typecheck (ubuntu-latest, 3.9) (push) Successful in 1m49s
Lint / format (push) Successful in 42s
Build / Test on macOS-latest (push) Has been cancelled
Build / Test on windows-latest (push) Has been cancelled
CodeQL / Analyze (python) (push) Failing after 1m31s
snapshot of https://github.com/ActivityWatch/aw-server.git (master, 2026-09-16; blobs > 131072B omitted)
2026-09-16 00:20:00 +05:00

1.6 KiB

aw-server

Build Status Coverage Status

ActivityWatch server, for secure storage and retrieval of all your Quantified Self data.

Note: In the future this will no longer be the default server used by ActivityWatch, instead we will be using aw-server-rust. The fate of this repo is uncertain, but it will likely be around and maintained for a while (as a reference implementation, for prototyping, etc).

Build and Install

To install program and dependencies, Poetry is required. You'll want to activate a venv before building.

make build

The aw-server binary should now be available to you in your PATH (if it is set correctly).

Usage

Run aw-server:

aw-server

Development

If you want to run aw-server in development, you probably want to run a development instance beside your personal (stable) instance. You can do this by giving aw-server the --testing flag. This will start the server on another port and use a separate datastore.

aw-server --testing

API Examples

You can also get a very decent API browser by browsing to localhost:5600 after starting the server.

There are also some API examples in the documentation.