Skip to content

Self-hosting MedTracker

The 0.6 application uses Rust/Loco and PostgreSQL 18. Read the release notes before installing it. Start with a new empty database and fresh accounts; existing Rails data, passwords, passkeys and sessions are not imported.

There is no supported rollback from 0.6 to Rails. A full Rails export at the transition is an operator action, not an automatic import or a claim that an export has already happened. Any retained Rails site contains only its pre-cutover state. Preserve data written in 0.6 with a separate Rust-side export; returning to the old site would not carry those records back. These notes do not promise that Rails can import that export or provide a lossless switchback.

Local evaluation

Follow the technical quick start to install the selected tools, prepare a private development database and start the Rust server. Synthetic fixtures are for local evaluation only. Keep them off public/shared networks and do not enter real medication records into a fixture installation.

A reachable installation

Operators should use the fresh Rust rollout guide and Loco image guide. Configure a dedicated database, restricted runtime credentials, persistent secrets, private object storage and the public HTTPS origin. Run the server, workers and a single scheduler through the deployment's existing controller.

The Loco image workflow can publish tested images for both supported Linux architectures. It is separate from the Rails publisher. Publishing an image does not deploy an application, and these notes do not claim a production rollout has happened.

Do not reset or repurpose an existing installation's database. Keep retained Rails data and secrets separate. Rust-created data has no reverse migration into Rails. Follow the rollout guide's stop and recovery boundaries if a new installation encounters a problem.

Once an operator has prepared access, household members can follow the family setup guide. MedTracker supplements an existing medication routine; it should not be the sole source of medication reminders.