-> Inter-Data -> Technik -> Installation

Installation

OpensourceERP lokal oder per Docker einrichten

Docker (empfohlen)

1. Repository klonen

git clone https://github.com/Ciatronical/opensource-erp.git
cd opensource-erp/docker

2. Konfiguration

cp .env.example .env
nano .env

DOMAIN

Domain für SSL

erp.example.com

POSTGRES_PASSWORD

DB-Passwort

muss gesetzt werden

WEB_HTTP_PORT

HTTP-Port

8080

WEB_HTTPS_PORT

HTTPS-Port

8443

3. Starten

./scripts/docker.sh up-db
./scripts/docker.sh up-web

Erreichbar unter http://localhost:8080. Für SSL DOMAIN und CERTBOT_EMAIL in .env setzen — der Container holt das Zertifikat automatisch.

Lokale Installation

1. Abhängigkeiten

sudo apt update && sudo apt upgrade -y
sudo apt install -y \
  git nodejs npm \
  php php-cli php-pgsql php-mbstring php-xml php-curl php-ssh2 \
  postgresql postgresql-contrib qrencode

2. Repository klonen und starten

git clone https://github.com/Ciatronical/opensource-erp.git
cd opensource-erp
./scripts/run-dev.sh

Erreichbar unter http://localhost:5173. Für den Produktivbetrieb steht ein Apache-Konfigurationsscript bereit.

3. Setup-Wizard

Beim ersten Aufruf im Browser startet automatisch der Setup-Wizard. Dort werden Datenbankzugangsdaten eingegeben und die settings.ini erzeugt.

Troubleshooting

Port belegt?

sudo lsof -i :5173
sudo lsof -i :8000

Datenbank-Verbindung?

PostgreSQL läuft? sudo systemctl status postgresql

Docker-Logs:

docker compose logs -f web
docker compose logs -f db

Häufig gestellte Fragen

Welche Voraussetzungen brauche ich?

Für Docker: Docker und Docker Compose. Für die lokale Installation: Git, Node.js, npm, PHP 8 mit Extensions (pgsql, mbstring, xml, curl, ssh2) und PostgreSQL 16.

Wie lange dauert die Einrichtung?

Per Docker in wenigen Minuten. Die lokale Installation dauert je nach Vorkenntnissen 15–30 Minuten.

Gibt es einen Setup-Assistenten?

Ja. Beim ersten Aufruf im Browser startet ein Setup-Wizard, der durch die Datenbank-Konfiguration führt.