Skip to content

Installation

This guide covers installing MedUX for evaluation or production use. If you want to set up a development environment, or develop a plugin, see the Developer Setup and Plugins instead.

Prerequisites

  • Python 3.13+
  • uv (recommended package manager)
  • PostgreSQL (for production)

Quick Install

Create a new project and add medux as dependency, as well as plugins you want to add to this appliance:

uv init mymedux && cd mymedux
uv add medux
uv add medux-plugin-cashbook

Initial Setup

Create a .env file for your database configuration:

DATABASE_ENGINE=django.db.backends.postgresql
DATABASE_NAME=medux
DATABASE_USER=medux
DATABASE_PASS=<secure-password>
SECRET_KEY=<your-secret-key>
DEBUG=False

Run the initial setup (with the project's .venv active):

source .venv/bin/activate
medux migrate
medux syncplugins
medux initialize
medux collectstatic

The initialize command creates an initial admin user (username: admin, password: admin). Change this password immediately after first login.

Next Steps