📦 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`

2.4 KiB Raw Permalink Blame History Unescape Escape