dgsoft/collabrix
1
0
Fork 0
mirror of https://github.com/OHV-IT/collabrix.git synced 2025-12-15 16:48:36 +01:00
Code Issues Packages Projects Releases Wiki Activity
collabrix/SYSTEMD_INSTALL_README.md
DGSoft b10078dc2e Add Systemd Service for Persistent Background Services 
- teamchat.service: Systemd service configuration
- install-service.sh: Automated service installer
- SYSTEMD_INSTALL_README.md: Complete installation guide
- Automatic start on boot with failure recovery
- Proper logging to systemd journal
- Root user configuration (can be customized)
- Troubleshooting and management commands
2025-12-09 22:33:17 +01:00

2.6 KiB
Raw Blame History

Team Chat System - Systemd Service Installation

🚀 Schnellinstallation

# Als root ausführen
sudo ./install-service.sh

📋 Was passiert bei der Installation?

  1. Service-Datei kopieren → /etc/systemd/system/teamchat.service
  2. Systemd neu laden → systemctl daemon-reload
  3. Service aktivieren → Automatischer Start beim Boot
  4. Service starten → Sofortiger Start
  5. Status prüfen → Bestätigung der erfolgreichen Installation

🎯 Nach der Installation

Service verwalten:

# Status prüfen
sudo systemctl status teamchat

# Service stoppen
sudo systemctl stop teamchat

# Service starten
sudo systemctl start teamchat

# Neustart
sudo systemctl restart teamchat

Logs anzeigen:

# Live-Logs
sudo journalctl -u teamchat -f

# Letzte 50 Zeilen
sudo journalctl -u teamchat -n 50

Service deaktivieren:

# Automatischen Start deaktivieren
sudo systemctl disable teamchat

# Service komplett entfernen
sudo systemctl stop teamchat
sudo rm /etc/systemd/system/teamchat.service
sudo systemctl daemon-reload

🔧 Troubleshooting

Service startet nicht:

# Detaillierte Fehler anzeigen
sudo systemctl status teamchat -l

# Systemd-Logs prüfen
sudo journalctl -u teamchat --no-pager

Berechtigungsprobleme:

# Service-Datei prüfen
ls -la /etc/systemd/system/teamchat.service

# User in Service-Datei anpassen (falls nicht root)
sudo nano /etc/systemd/system/teamchat.service
# User=your_username ändern
sudo systemctl daemon-reload
sudo systemctl restart teamchat

Port-Konflikte:

# Prüfe verwendete Ports
sudo netstat -tlnp | grep -E ':(8000|5173|80)'

# Ports in service-manager.sh anpassen falls nötig
sudo nano /home/OfficeDesk/service-manager.sh

📊 Service-Details

  • Name: teamchat
  • Beschreibung: Team Chat System
  • User: root (kann angepasst werden)
  • Working Directory: /home/OfficeDesk
  • Auto-Start: Beim System-Boot
  • Restart: Bei Fehlern automatisch neu starten
  • Logs: Systemd Journal (journalctl)

🔄 Alternative: Screen/Tmux

Falls Systemd nicht gewünscht ist:

# Screen installieren
sudo apt install screen

# Session starten
screen -S teamchat

# Services starten
./service-manager.sh start

# Detach (Strg+A, D)
# Zurück: screen -r teamchat

✅ Erfolgreiche Installation prüfen

# Sollte "active (running)" zeigen
sudo systemctl status teamchat

# Sollte die Webseite laden
curl -I http://192.168.0.12

# Sollte JSON zurückgeben
curl http://localhost:8000/docs