mirror of
https://github.com/OHV-IT/collabrix.git
synced 2025-12-15 16:48:36 +01:00
b10078dc2e
- 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
126 lines
2.6 KiB
Markdown
126 lines
2.6 KiB
Markdown
# Team Chat System - Systemd Service Installation
|
|
|
|
## 🚀 Schnellinstallation
|
|
|
|
```bash
|
|
# 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:
|
|
```bash
|
|
# 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:
|
|
```bash
|
|
# Live-Logs
|
|
sudo journalctl -u teamchat -f
|
|
|
|
# Letzte 50 Zeilen
|
|
sudo journalctl -u teamchat -n 50
|
|
```
|
|
|
|
### Service deaktivieren:
|
|
```bash
|
|
# 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:
|
|
```bash
|
|
# Detaillierte Fehler anzeigen
|
|
sudo systemctl status teamchat -l
|
|
|
|
# Systemd-Logs prüfen
|
|
sudo journalctl -u teamchat --no-pager
|
|
```
|
|
|
|
### Berechtigungsprobleme:
|
|
```bash
|
|
# 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:
|
|
```bash
|
|
# 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:
|
|
|
|
```bash
|
|
# 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
|
|
|
|
```bash
|
|
# 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
|
|
``` |