Never run out of your medications again.
A medication tracking and planning app with stock monitoring, intake schedules, and reminder notifications.

This app was built using the latest available ChatGPT models. Use at your own risk.

Your health is your responsibility. This app may contain bugs. Follow your doctor's instructions closely, keep track of your medication supply, and plan ahead for reordering.

Think of this app as a helpful tool, but make all health decisions independently!

• Features
• Screenshots
• Getting Started
• Configuration
• Development

• Optional medication lookup in the editor on desktop and mobile
• Supports RxNorm, openFDA, and EMA with source labels
• Review-and-apply flow with package-size suggestions when available
• Manual entry remains available

• Track exact stock with package profiles (blister, bottle, tube, liquid container, inhaler, injection)
• Display remaining days of supply
• Automatic calculation based on intake schedule
• Record package-aware as-needed consumption for active medications without a regular schedule
• Manual stock corrections

• One-click refill
• Complete refill history per medication
• Automatic stock updates after each refill

• Daily, weekly, or custom intervals per medication
• Independent schedules for each medication
• Create or edit a medication without a regular schedule on desktop and mobile, then add or remove schedules later
• Optional timeline filters for dashboard and shared schedule views

• Record now is available for active medications with no regular schedule; scheduled, ended, and obsolete medications keep their existing behavior
• Quantity, unit, and stock effect follow the medication's package profile. Topical use records one application without guessing a measurable stock reduction
• Attribute an intake to one of the medication's current people or choose None / self
• Keep an auditable active and reversed history, with corrections recorded as a reversal followed by a separate replacement
• Include as-needed history and journals in reports and export/import backups without exposing event details or mutation actions on public shares

See Unscheduled medications and Record now for the inventory, retry, correction, sharing, and backup rules.

• Notifications before stock runs out
• Configurable warning thresholds
• Intake reminders via push notifications

• Calculate medication demand for a trip or date range with package-aware units
• Send demand reports via email or push notification

• Generate medication reports as PDF, Markdown, or plain text
• Include scheduled history plus separate active as-needed totals and active/reversed audit entries with journal context

• Manage medications for multiple people
• Share schedules via link. Recipients can mark doses as taken, you see it live
• Optionally allow shared links to view and edit intake journal notes for their visible schedule window
• Optionally embed the medication overview directly on shared links via a settings toggle

• Export all your data (medications, scheduled dose history, as-needed intake events, intake journal notes and moods, settings) as JSON
• Review validated import contents before replacing current data
• Optionally download a fresh backup before confirming import
• Import previously exported data with automatic ID remapping
• Choose whether to include sensitive data in exports

• Email via SMTP
• Push notifications via ntfy, Pushover, Gotify, Telegram, Discord & more (Shoutrrr)
• Supports stock warnings and intake reminders

• Fully self-hosted
• SSO via OIDC (Authelia, Authentik, Pocket ID, Keycloak)
• Non-root containers
• Dark mode included 😎

The easiest way to deploy MedAssist-ng is with Docker Compose:

git clone https://github.com/DanielVolz/medassist-ng.git
cd medassist-ng
cp .env.example .env
docker compose -p medassist-ng up -d

Before running docker compose, choose an authentication mode in .env.

For non-local deployments, enable authentication:

AUTH_ENABLED=true
JWT_SECRET=<output-of-openssl-rand-hex-32>
REFRESH_SECRET=<output-of-openssl-rand-hex-32>
COOKIE_SECRET=<output-of-openssl-rand-hex-32>

For a local/private-only trial that is not reachable from other networks, explicitly set:

ALLOW_UNAUTHENTICATED=true

Production startup refuses AUTH_ENABLED=false unless that local-only override is present.

Open http://localhost:4174 and start tracking your medications.

After the containers start, confirm the stack is actually healthy:

1. Run docker compose ps and confirm the backend service is healthy and the frontend service is running.
2. Open http://localhost:4174/api/health and confirm the backend responds through the frontend proxy with JSON that includes "status":"ok".
3. Open http://localhost:4174 and confirm the app loads.

GitHub releases also attach a digest-pinned docker-compose.pinned.yml. The published container images now include OCI SBOM/provenance attestations and must pass container smoke tests before release completion.

If you use MedAssist from another device or domain, set PUBLIC_APP_URL to the address people actually use to open the app.

Public deployments must enable authentication. The default Docker Compose setup exposes only the frontend; keep the backend private and put public installations behind HTTPS.

More deployment and security options are documented in docs/CONFIGURATION.md.

Configure the application with environment variables in .env. Keep the basic container settings in the README and use the dedicated docs for the full reference.

Optional but commonly needed:

Detailed configuration references:

• Full configuration reference: docs/CONFIGURATION.md
• Push notifications: docs/PUSH_NOTIFICATIONS.md
• Default user settings: docs/DEFAULT_USER_SETTINGS.md

Development setup and local commands are documented in docs/DEVELOPMENT.md.

For cross-stack maintenance work and pre-PR validation, the repository root now exposes:

npm run check
npm run build

This project was inspired by MedAssist by njic.