Repolode
Submit
njic

njic/medassist

Self-hosted Node.js app for tracking medication inventory, reorder reminders by email, and travel medication lists.

View on GitHub
Stars
162
Forks
4
Open issues
14
Last commit
21 days ago

What is it?

MedAssist is a self-hosted web application for managing daily medications. You enter each medication with its current quantity, dose usage, and schedule, and the dashboard shows days left and the date by which a resupply is needed. Stock levels are compared against expected usage, which helps confirm whether a dose was taken.

The app can send email reminders over SMTP when supplies run low, with configurable thresholds, send time and repeat interval. A planner view builds a list of medications needed for a chosen date range, such as a trip, and can email that list. It runs as a Docker container with a SQLite database file, or directly with Node.js and Express.

The author notes it is a hobby project without a login system, and states that it is not medical advice and should not replace a doctor's instructions.

Key features

  • 01Tracks medication inventory and shows days left before each medication runs out
  • 02Sends email reminders over SMTP when stock falls below a set threshold
  • 03Generates a travel medication list for a chosen date range, optionally sent by email
  • 04Dashboard shows upcoming schedules for today and tomorrow
  • 05Runs via Docker or directly with Node.js, storing data in SQLite

Use cases

  • Managing several regular prescriptions and knowing when to reorder
  • Preparing a medication list before travel
  • Self-hosting a household medication tracker on a home server or NAS

Quick start

  1. 1

    Run the Docker container using the provided docker-compose.yaml or docker run command

    docker run -p 3111:3111 -v /path/to/database/directory:/app/database --restart always -e TZ=Etc/UTC medassist
  2. 2

    Open the GUI in your browser

Things to know

  • The author states the project is a hobby with no active development, and features listed as incoming have not shipped.
  • The app has no login, and the author is unsure of its security.
  • The author warns the app may contain serious flaws and should not be relied on for health decisions.
  • The license is GPL-3.0, a copyleft license that requires derivative works to be open source.

In collections

Self-hosted appsDatabases & SQL tools

Topics

#medication#health#self-hosted#nodejs#express#sqlite#docker#reminders

FAQ

What is medassist?
Self-hosted Node.js app for tracking medication inventory, reorder reminders by email, and travel medication lists. MedAssist is a self-hosted web application for managing daily medications. You enter each medication with its current quantity, dose usage, and schedule, and the dashboard shows days left and the date by which a resupply is needed. Stock levels are compared against expected usage, which helps confirm whether a dose was taken.
Is medassist free to use? What license does it have?
medassist is open source under the GPL-3.0 license. Check the license terms before using it in commercial products.
Is medassist still maintained?
Actively maintained. The last commit to medassist was on Oct 17, 2026.
What can I use medassist for?
Managing several regular prescriptions and knowing when to reorder Preparing a medication list before travel Self-hosting a household medication tracker on a home server or NAS
How do I install medassist?
Run the Docker container using the provided docker-compose.yaml or docker run command: docker run -p 3111:3111 -v /path/to/database/directory:/app/database --restart always -e TZ=Etc/UTC medassist Open the GUI in your browser
Where can I get medassist?
The source code and installation instructions are on GitHub: https://github.com/njic/medassist

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects