3.3 KiB
Installation
Voraussetzungen
- Docker ≥ 24
- Docker Compose ≥ 2.20 (in neueren Docker-Versionen enthalten)
- Git
Automatische Installation
Das Script install.sh übernimmt die gesamte Installation: es erkennt die Linux-Distribution, installiert git, curl und Docker, klont das Repository in das gewünschte Verzeichnis und legt die .env-Datei an.
Das Script muss vor dem Klonen des Repositories heruntergeladen werden – es erledigt das Klonen selbst:
curl -fsSL https://codeberg.org/fds2610/Steuerkram/raw/branch/main/install.sh -o install.sh
sudo bash install.sh
Das Script muss als root ausgeführt werden, da es Pakete installiert und ggf. den Docker-Dienst aktiviert.
Nach der Installation die .env-Datei im gewählten Installationsverzeichnis anpassen und die Container starten:
cd /opt/Steuerkram # oder das gewählte Verzeichnis
docker compose up -d
Manuelle Installation
1. Repository klonen
git clone <repository-url> steuerkram
cd steuerkram
2. Konfiguration anpassen
cp .env.example .env
DB_PASS=sicheres-passwort # Datenbankpasswort – in docker-compose.yml spiegeln
APP_SECRET=zufaelliger-string # Zufälligen langen String eintragen (für Sessions)
Außerdem in docker-compose.yml das MARIADB_PASSWORD im db-Service auf denselben Wert wie DB_PASS setzen.
3. Container starten
docker compose up -d
Beim ersten Start werden automatisch:
- die Datenbank initialisiert
- der SKR03-Kontenrahmen eingespielt
- das Docker-Image mit PHP-Abhängigkeiten (mPDF) gebaut
4. Anwendung aufrufen
http://localhost:8080
Beim ersten Aufruf erscheint die Ersteinrichtung: dort den ersten Benutzer-Account anlegen. Danach ist die Anwendung passwortgeschützt.
Port ändern
Der Standard-Port ist 8080. Um ihn zu ändern, die ports-Zeile in docker-compose.yml anpassen:
ports:
- "9090:80" # Beispiel: Port 9090 auf dem Host
Upload-Limit anpassen
Die maximale Dateigröße für Beleganhänge ist auf 20 MB voreingestellt (php/uploads.ini). Um das Limit zu ändern:
upload_max_filesize = 20M
post_max_size = 20M
docker compose up -d --build
Systemd-Service einrichten
Damit Steuerkram automatisch beim Systemstart startet, liegt im Repository die Datei steuerkram.service.
1. Service-Datei installieren
sudo cp steuerkram.service /etc/systemd/system/steuerkram.service
Die Datei setzt WorkingDirectory=/opt/Steuerkram voraus. Falls das Repository woanders liegt, den Pfad anpassen:
sudo nano /etc/systemd/system/steuerkram.service
2. Service aktivieren und starten
sudo systemctl daemon-reload
sudo systemctl enable steuerkram
sudo systemctl start steuerkram
3. Status prüfen
sudo systemctl status steuerkram
journalctl -u steuerkram -f # Live-Log inkl. Migrations-Ausgabe
Wichtige Befehle
| Befehl | Wirkung |
|---|---|
sudo systemctl start steuerkram |
Container starten |
sudo systemctl stop steuerkram |
Container stoppen |
sudo systemctl restart steuerkram |
Neustart (z.B. nach Update) |
sudo systemctl status steuerkram |
Aktueller Status |