Skip to content

Self-Hosting Setup

This guide walks through running MedTracker on your own computer or server.

🏁 Before you begin

If you've never used your computer's "Terminal" before, don't worry! Here's how to find it:

  • Windows: Search for "PowerShell" or "Command Prompt" in your Start menu.
  • Mac: Open "Finder", go to "Applications" → "Utilities", and double-click Terminal.

What you'll need

You'll need to install these three tools before we start. They are the "engine" that runs MedTracker:

  1. Docker Desktop: download and install the version for your computer.
  2. Git: follow the instructions for your computer.
  3. Task: follow the instructions for your computer (e.g., brew install go-task/tap/go-task on Mac).

1. Download MedTracker

Open your Terminal and paste these commands (one line at a time):

git clone https://github.com/damacus/med-tracker.git
cd med-tracker

2. Start the App

Now, let's start the app's services:

task dev:up

This might take a few minutes the first time as it downloads the necessary parts. If it asks for permission to access your files or network, click Allow.

3. Add Some Example Data

To make it easier to see how it works, we'll add some "dummy" data (like example people and medicines):

task dev:seed

4. Open MedTracker in Your Browser

Now, open your web browser (like Chrome or Safari) and go to:

👉 http://localhost:3000

You can log in with:

  • Email: admin@example.com
  • Password: password

What's next?

Now that the app is running, you can: