Repolode
Submit
afairgiant

afairgiant/MediKeep

A self-hosted personal health record app for organizing medical records, medications and reports, built with a React frontend and FastAPI backend.

View on GitHub
Stars
554
Forks
49
Open issues
65
Last commit
6 hours ago

What is it?

MediKeep is a self-hosted application for keeping personal medical information in one place. It covers health records, medications with dosages and schedules, and a report builder for generating custom health reports to share with healthcare providers. A dashboard gives an overview of recent records and activity.

The app is built with a React frontend and a FastAPI backend, served together on a single port. The included Docker Compose setup runs it alongside a PostgreSQL database, with persistent volumes for uploads, logs and backups. Backups can be made from the admin dashboard or with a backup/restore CLI that can be scheduled with cron.

Authentication supports local accounts, and SSO is optional and disabled by default. Google and GitHub are listed as officially supported and tested, while generic OIDC providers are expected to work but are not yet tested. The project is noted as under active development.

Key features

  • 01Track health records, medications, dosages and schedules in one place
  • 02Generate custom health reports for sharing with healthcare providers
  • 03Dashboard overview of recent records and activity
  • 04Backup and restore from the admin dashboard or a scheduled CLI
  • 05Optional SSO with Google and GitHub; OIDC support is untested
  • 06Runs via Docker Compose with PostgreSQL

Use cases

  • Keeping a family's medical history and medication list organized in one place
  • Preparing a summarized health report before a doctor's appointment
  • Hosting a private health record system on a home server or LAN

Quick start

  1. 1

    Install Docker and Docker Compose

  2. 2

    Create docker-compose.yml and a .env file from the README examples

  3. 3

    Start the containers

    docker compose up -d
  4. 4

    Open the app in your browser at localhost:8005

Things to know

  • The license is not clearly stated, so reuse terms are unclear.
  • Setup requires Docker, PostgreSQL and manual configuration of secrets and environment variables.
  • The README says the project is actively being worked on and recently had breaking renames.

In collections

Self-hosted appsPrivacy & local-first toolsDatabases & SQL tools

Topics

#health-records#self-hosted#medical#fastapi#react#postgresql#docker#privacy

FAQ

What is MediKeep?
A self-hosted personal health record app for organizing medical records, medications and reports, built with a React frontend and FastAPI backend. MediKeep is a self-hosted application for keeping personal medical information in one place. It covers health records, medications with dosages and schedules, and a report builder for generating custom health reports to share with healthcare providers. A dashboard gives an overview of recent records and activity.
Is MediKeep free to use? What license does it have?
MediKeep is open source under the Other license. Check the license terms before using it in commercial products.
Is MediKeep still maintained?
Actively maintained. The last commit to MediKeep was on Nov 7, 2026.
What can I use MediKeep for?
Keeping a family's medical history and medication list organized in one place Preparing a summarized health report before a doctor's appointment Hosting a private health record system on a home server or LAN
How do I install MediKeep?
Install Docker and Docker Compose Create docker-compose.yml and a .env file from the README examples Start the containers: docker compose up -d Open the app in your browser at localhost:8005
Where can I get MediKeep?
The source code and installation instructions are on GitHub: https://github.com/afairgiant/MediKeep

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

Related projects