Deployment

This guide covers deploying MedUX in a production environment.

Warning

MedUX is in pre-alpha. The deployment process is not yet finalized. This page documents the general approach — details will be updated as the project matures.

Recommended Stack

Component	Recommendation
Web server	Nginx (reverse proxy)
ASGI server	Daphne
Database	PostgreSQL
Channel layer	Redis (for WebSocket)
Process manager	systemd
Python packages	uv

General Steps

1. Install MedUX — see Installation
2. Configure — set environment variables in .env (see Configuration)
3. Set up the database — create a PostgreSQL database and user
4. Run migrations — medux migrate
5. Sync plugins — medux syncplugins
6. Initialize — medux initialize
7. Collect static files — medux collectstatic
8. Configure Nginx — set up as a reverse proxy to Daphne
9. Set up systemd — create a service unit for Daphne
10. TLS — set up SSL/TLS certificates (e.g., via Let's Encrypt)

Production Checklist

• DEBUG=False in .env
• Strong SECRET_KEY set
• ALLOWED_HOSTS configured
• STATIC_ROOT and MEDIA_ROOT configured
• PostgreSQL (not SQLite) as database backend
• Redis configured as channel layer backend
• Static files served by Nginx
• TLS configured
• Backup strategy in place (see Backup & Maintenance)
• Admin password changed from default