-> Inter-Data -> Technik -> Installation

Installation

LxCars lokal oder per Docker einrichten

Installation ohne Docker

1. Voraussetzungen

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

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

3. Starten

Development:

./scripts/run-dev.sh

Läuft auf http://localhost:5173

Production:

sudo cp install/apacheOpensourceErp.conf /etc/apache2/sites-available/
sudo a2enmod rewrite proxy_fcgi setenvif
sudo a2ensite apacheOpensourceErp
sudo systemctl restart apache2

./scripts/run-build.sh

Läuft auf http://localhost

4. Setup

Beim ersten Aufruf im Browser startet automatisch der Setup-Wizard. Dort werden die Datenbank-Zugangsdaten eingegeben und eine settings.ini angelegt.


Installation mit Docker

1. Repository klonen

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

2. Konfiguration

cp .env.example .env
nano .env

Wichtige Werte in .env:

Variable Beschreibung Standard
DOMAIN Domain für SSL-Zertifikat erp.example.com
POSTGRES_PASSWORD Datenbank-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

Die Anwendung läuft auf http://localhost:8080

SSL aktivieren

Für Let’s Encrypt SSL-Zertifikate DOMAIN und CERTBOT_EMAIL in .env setzen. Der Web-Container holt die Zertifikate automatisch.


Troubleshooting

Port bereits belegt?

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

Datenbank-Verbindung fehlgeschlagen?

  • backend/config/api.config.php prüfen
  • PostgreSQL läuft? sudo systemctl status postgresql

Docker-Logs:

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

Häufig gestellte Fragen

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

Die Docker-Installation ist in wenigen Minuten erledigt. Die lokale Installation dauert je nach Vorkenntnissen 15-30 Minuten.

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

Ja. Das System unterstützt den Datenimport aus bestehenden Installationen. Außerdem gibt es ein automatisches Datenbank-Migrations-System.