📦 Minimal Requirements & Installation Guide
✅ Minimal Requirements
- Docker Compose V2
- Git installed (git --version)
🔁 Step-by-Step Installation
- Clone the repository
First, clone the self-hosted Docker Compose setup from our private repository:
git clone https://gitea.phx-erp.de/PHXGMBH/docker-compose-selfhost.git
🔐 Note: You’ll not be prompted to enter your Gitea credentials to access the repository, in case it happens contact administrators.
- Navigate to the cloned project
cd docker-compose-selfhost
- Edit your environment variables
- Open the .env file and adjust configurations only before the first boot.
Most importantly:
# ====== Phoenix Super Admin Configuration ======
SUPER_ADMIN_USER_PASSWORD=your-secure-password-here
You can also configure other services like database, pgAdmin, mail server, and Redis in this same .env file.
Example:
NODE_ENV=production
POSTGRES_PASSWORD="8*6&Ti3TJxN^"
PGADMIN_DEFAULT_EMAIL="info@phx-erp.de"
PGADMIN_DEFAULT_PASSWORD="8*6&Ti3TJxN^"
SUPER_ADMIN_USER_PASSWORD=123
⚠️ IMPORTANT: ONE-TIME SETTING ONLY
🛑 The .env variable SUPER_ADMIN_USER_PASSWORD is only used on the first boot to create the super admin user.
After the system has been started once:
- Depending on what you changing it can break the system.
- To change the super admin password, use the Phoenix ERP UI directly (under Admin settings).
- Pull the Docker images
Run:
docker compose pull
- Set pgAdmin data folder permissions
To ensure pgAdmin can access its persistent storage, run:
sudo chown -R 5050:5050 ./pgadmin/data
🚀 Ready to go
Now you’re ready to launch the stack:
docker compose up -d
You can access log services like pgAdmin, Postgres, Phoenix ERP, and others after containers are running.
🌐 Accessing the System
| Service | URL | Credentials |
|---|---|---|
| Phoenix ERP | http://HOST_IP | login: superadmin and password as configured in .env -> SUPER_ADMIN_USER_PASSWORD |
| pgAdmin | http://HOST_IP/pgadmin4/ | Email: info@phx-erp.de Password: from SUPER_ADMIN_USER_PASSWORD |