selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

GitHub
medassist logo

Self-host medassist

v0.16.2

Self-hosted medication tracking and reminder app

BetaOpen SourceGPL-3.0
Updatedlast year
LanguageJavaScript
Setup difficultyEasy
Stars
161
Port
3111 (HTTP web interface)
Docker
ghcr.io/njic/medassist
Install with Docker
Dashboard showing medication overview, reorder reminders, and upcoming schedulesConfiguration screen for adding and managing medications with schedulesTravel planner with date range selection and medication listSettings page for username, email notifications, and SMTP configurationMedication update screenMobile dashboard viewMobile schedules viewTravel planner email previewEmail notification example

What is medassist?

MedAssist is a personal medication management tool built by a hobbyist developer to help their partner manage daily medications. The web application tracks medication inventory levels, calculates days until medications run out, and sends email alerts when supplies are low. It includes a travel planner that generates a list of all medications needed for a specified date range with quantities, and can email that list. The dashboard shows upcoming medication schedules for today and tomorrow. A configuration screen lets users add medications with complex dosing schedules (multiple times per day, different intervals). Settings allow configuring SMTP for email notifications, setting the notification threshold (default 10 days), and a display username. The app stores data in a SQLite database file (medication.db) and has no user authentication — the developer notes login is a planned feature. It can be deployed via Docker (image on ghcr.io) or run directly with Node.js. The project is licensed under GPL-3.0 and the author notes they are not a medical or programming professional, so the app should not be relied upon for critical health decisions.

Should you self-host medassist?

medassist scores 40/100 on selfhost.directory (how scoring works) and ranks #24 of 31 in Health & Fitness. It has 161 GitHub stars.

There was no stable release in the past 12 months, so check the repository's recent activity before you rely on it.

Setup is easy: most people get it running in one sitting. An official Docker image is available. It is GPL-3.0-licensed and written mostly in JavaScript.

Its closest alternative on selfhost.directory is wger (73/100, 7 201 stars). It scores higher overall, so compare the two before you pick. See medassist vs wger side by side.

Features

  • Complex dosing schedules
  • Dashboard with upcoming schedules
  • Email travel list
  • Low stock email reminders
  • Medication inventory tracking
  • Travel medication planner

medassist README

How to install medassist

Install medassist with Docker

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

GUI is available on http://localhost:3111

How to configure medassist

  • Min Days10Minimum days left before medication expires to trigger notifications

    Minimum days left before medication expires to trigger notifications

  • Recipient EmailComma-separated list of email addresses to receive notifications

    Comma-separated list of email addresses to receive notifications

  • RepeatNumber of days between notification emails to avoid too frequent emails

    Number of days between notification emails to avoid too frequent emails

  • Send TimeTime of day when notification emails are sent

    Time of day when notification emails are sent

  • SMTP HostSMTP server hostname for email notifications

    SMTP server hostname for email notifications

  • SMTP PasswordSMTP authentication password

    SMTP authentication password

  • SMTP PortSMTP server port

    SMTP server port

  • SMTP UsernameSMTP authentication username

    SMTP authentication username

  • TZEtc/UTCTimezone for the container (e.g., Etc/UTC)

    Timezone for the container (e.g., Etc/UTC)

    values: Any valid IANA timezone

  • UsernameUserDisplay name used on dashboard and in email notifications

    Display name used on dashboard and in email notifications

medassist releases & version history

More in Health & Fitness

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…