MANTIS Installation

2. Installation

Windows

1. Lade MANTIS_2607.1.0_x64-setup.exe von cosic.eu/download/mantis herunter
2. Fuehre die Setup-Datei aus (Doppelklick)
3. Folge dem Installations-Wizard (Standard-Einstellungen sind empfohlen)
4. MANTIS startet automatisch nach der Installation

macOS

1. Lade MANTIS-x.x.x.dmg herunter
2. Oeffne die DMG-Datei und ziehe MANTIS in den Applications-Ordner
3. Beim ersten Start: Rechtsklick → "Oeffnen" (Gatekeeper-Freigabe)

Linux

1. Lade .deb (Debian/Ubuntu) oder .AppImage von cosic.eu/download/mantis herunter
2. Installation:

   # Debian/Ubuntu (Dateiname enthaelt die aktuelle Version)
   sudo dpkg -i MANTIS_2607.1.0_amd64.deb
   # Falls Abhaengigkeiten fehlen (z.B. libwebkit2gtk-4.1-0):
   sudo apt -f install
   
   # AppImage (alle Distros, keine Installation noetig)
   chmod +x MANTIS_2607.1.0_amd64.AppImage
   ./MANTIS_2607.1.0_amd64.AppImage

3. Ersteinrichtung (Onboarding)

Beim ersten Start fuehrt dich ein 4-Schritt-Wizard durch die Einrichtung:

Schritt 1: Willkommen

Sprache waehlen (Deutsch / English) und Weiter klicken.

Schritt 2: Master-Passwort festlegen

• Staerke-Anzeige hilft bei der Wahl
• Passwort ist spaeter aenderbar (alle Daten werden neu verschluesselt)

Schritt 3: Recovery Key sichern

• Klicke "Herunterladen" und speichere die Datei an einem sicheren Ort (ohne Download geht es nicht weiter)
• Bestaetige anschliessend per Checkbox, dass der Key sicher verwahrt ist
• Idealerweise: Ausdrucken und im Tresor/Safe aufbewahren

Schritt 4: Erster Mandant oder Demo

Lege deinen ersten Mandanten (Kunden) an oder starte mit Demo-Daten zum Ausprobieren.

4. Erste Schritte

Mandant anlegen

Strg+N oder "+" Button in der Sidebar. Gib Name, Kundennummer, Kontaktdaten ein.

Zugaenge erfassen

Waehle einen Mandanten → Tab "Zugaenge" → "Neuer Zugang". Passwoerter werden automatisch verschluesselt.

Timer starten

Klicke auf das Timer-Symbol in der Statusbar oder starte direkt aus einem Ticket heraus. Jeder Timer zeigt Mandant + Aufgabe an.

Daten importieren

Ziehe eine Excel/CSV/KeePass/1Password-Datei per Drag&Drop in die App. MANTIS erkennt das Format automatisch.

Wichtige Shortcuts

5. Spaeter mit Server verbinden (optional)

Du kannst jederzeit von der lokalen Nutzung auf den Server-Modus wechseln:

1. Oeffne Einstellungen (Zahnrad-Symbol)
2. Navigiere zu "Server-Verbindung"
3. Gib die Server-URL ein (z.B. https://mantis.deinefirma.de)
4. Melde dich mit deinem Server-Account an (E-Mail + Passwort)
5. Waehle ob du lokale Daten zum Server migrieren moechtest

2. PostgreSQL einrichten

# PostgreSQL installieren (Ubuntu/Debian)
sudo apt update
sudo apt install postgresql postgresql-contrib

# Datenbank + Benutzer anlegen
sudo -u postgres psql <<EOF
CREATE USER mantis WITH PASSWORD 'SICHERES_PASSWORT_HIER';
CREATE DATABASE mantis OWNER mantis;
GRANT ALL PRIVILEGES ON DATABASE mantis TO mantis;
\q
EOF

Verbindung testen

psql -U mantis -d mantis -h localhost
# Sollte ohne Fehler verbinden. Beenden mit \q

3. MANTIS-Server installieren

# Server-Paket herunterladen (aktuelle URL auf cosic.eu/download/mantis)
wget https://download.cosic.eu/mantis/latest/mantis-server-2607.1.0-linux-x86_64.tar.gz
tar xzf mantis-server-2607.1.0-linux-x86_64.tar.gz
cd mantis-server

Binary installieren

sudo cp mantis-server /usr/local/bin/
sudo mkdir -p /var/lib/mantis/backups /var/lib/mantis/uploads
sudo chown -R mantis:mantis /var/lib/mantis

Server unter Windows (Alternative)

Der Server laeuft auch nativ auf Windows (mantis-server.exe), z.B. fuer kleine Teams ohne Linux-Server:

1. PostgreSQL fuer Windows (Version 14+) installieren; bei der Installation Passwort fuer den DB-Benutzer setzen
2. mantis-server-x.x.x-windows-amd64.zip herunterladen und z.B. nach C:\mantis\ entpacken
3. .env-Datei in C:\mantis\ anlegen (gleiche Variablen wie unter Linux, Schritt 4); Verzeichnisse anpassen:
   BACKUP_DIR=C:\mantis\backups und UPLOAD_DIR=C:\mantis\uploads
4. PostgreSQL-Tools in den PATH aufnehmen (z.B. C:\Program Files\PostgreSQL\16\bin) — der Server nutzt pg_dump/pg_restore fuer automatische Backups vor Migrationen
5. Testen: mantis-server.exe in einer Eingabeaufforderung im Ordner C:\mantis\ starten, dann curl http://localhost:3000/api/health
6. Fuer den Dauerbetrieb als Windows-Dienst registrieren, z.B. mit NSSM:

   nssm install MANTIS C:\mantis\mantis-server.exe
   nssm set MANTIS AppDirectory C:\mantis
   nssm start MANTIS

7. Windows-Firewall: Eingehende Regel nur fuer den Reverse-Proxy bzw. das LAN freigeben (Port 3000)

4. Konfiguration (.env)

Erstelle die Konfigurationsdatei:

sudo nano /etc/mantis/.env

Inhalt:

# === Pflicht ===
DATABASE_URL=postgres://mantis:SICHERES_PASSWORT_HIER@localhost:5432/mantis
JWT_SECRET=MINDESTENS_32_ZEICHEN_ZUFAELLIG_GENERIERT

# === Server ===
LISTEN_ADDR=0.0.0.0:3000

# CORS: Ohne diese Zeile gilt eine restriktive Default-Allowlist NUR fuer
# Tauri-Desktop-Clients (tauri://localhost + http://tauri.localhost).
# Wer CORS_ORIGINS setzt, UEBERSCHREIBT die Default-Liste komplett —
# Tauri-Origins dann mit auffuehren:
CORS_ORIGINS=https://mantis.deinefirma.de,tauri://localhost,http://tauri.localhost

# Hinter Reverse-Proxy (Nginx): Rate-Limiting auf echte Client-IP via
# X-Forwarded-For. NUR aktivieren, wenn der Server AUSSCHLIESSLICH
# ueber den Proxy erreichbar ist! (Default: false)
TRUSTED_PROXY=true

# === Verzeichnisse ===
BACKUP_DIR=/var/lib/mantis/backups
UPLOAD_DIR=/var/lib/mantis/uploads

# === Optional: E-Mail-Anbindung (IMAP/SMTP fuer Tickets) ===
EMAIL_ENABLED=false
# PFLICHT bei EMAIL_ENABLED=true: Schluessel fuer die AES-256-GCM-
# Verschluesselung gespeicherter IMAP/SMTP-Passwoerter.
# Erzeugen mit: openssl rand -hex 32  (ohne ihn startet der Server nicht!)
# SERVER_ENCRYPTION_KEY=64_HEX_ZEICHEN_HIER
SMTP_HOST=smtp.example.com
SMTP_PORT=587
SMTP_USER=mantis@example.com
SMTP_PASSWORD=smtp_passwort
SMTP_FROM=mantis@example.com

# === Optional: Performance ===
DB_POOL_SIZE=20
JWT_EXPIRY_HOURS=24
JWT_REFRESH_EXPIRY_DAYS=30
MAX_USERS_DEFAULT=5

Alle Konfigurationsoptionen

5. Server starten & testen

Erster Start (manuell)

# .env laden und Server starten
cd /etc/mantis
mantis-server

# Erwartete Ausgabe:
# MANTIS Server vX.Y.Z
# Connecting to database...
# Database ready.
# Listening on 0.0.0.0:3000

Health-Check

curl http://localhost:3000/api/health
# {"status":"ok","version":"x.y.z"}

curl http://localhost:3000/api/health/ready
# {"status":"ready","database":true,"version":"x.y.z"}

Ersten Admin-Account anlegen

Die Registrierung erfolgt ueber die MANTIS Desktop-App (naechster Schritt): Server-URL eingeben → "Registrieren" → erstellt Organisation + Admin-Benutzer.

6. Client mit Server verbinden

1. Installiere die MANTIS Desktop-App (siehe Client-Modus, Schritt 2)
2. Starte MANTIS und klicke auf "Mit Server verbinden" im Login-Bildschirm
3. Gib die Server-URL ein:
   https://mantis.deinefirma.de
4. Registriere dich (erster Benutzer = Admin + Organisation) oder melde dich mit E-Mail + Passwort an
5. Das Master-Passwort wird lokal zum Entschluesseln verwendet — es wird nie an den Server gesendet

Bestehende lokale Daten migrieren

Wenn du bereits Daten im Client-Modus erfasst hast, bietet MANTIS eine Migrationsoption an. Die lokalen Daten bleiben zusaetzlich erhalten.

7. Produktionsbetrieb

Systemd-Service einrichten

sudo nano /etc/systemd/system/mantis.service

[Unit]
Description=MANTIS Server
After=network.target postgresql.service
Wants=postgresql.service

[Service]
Type=simple
User=mantis
Group=mantis
WorkingDirectory=/etc/mantis
EnvironmentFile=/etc/mantis/.env
ExecStart=/usr/local/bin/mantis-server
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target

sudo systemctl daemon-reload
sudo systemctl enable mantis
sudo systemctl start mantis
sudo systemctl status mantis

Nginx Reverse Proxy (HTTPS)

sudo nano /etc/nginx/sites-available/mantis

server {
    listen 443 ssl http2;
    server_name mantis.deinefirma.de;

    ssl_certificate     /etc/letsencrypt/live/mantis.deinefirma.de/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/mantis.deinefirma.de/privkey.pem;

    client_max_body_size 50M;

    location / {
        proxy_pass http://127.0.0.1:3000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }

    location /api/ws {
        proxy_pass http://127.0.0.1:3000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}

sudo ln -s /etc/nginx/sites-available/mantis /etc/nginx/sites-enabled/
sudo certbot --nginx -d mantis.deinefirma.de
sudo systemctl reload nginx

Firewall (empfohlen)

# Nur SSH + HTTPS oeffnen — Port 3000 bleibt intern
sudo ufw allow OpenSSH
sudo ufw allow 443/tcp
sudo ufw enable
sudo ufw status

Backup-Strategie

# Taegliches PostgreSQL-Backup (Crontab)
crontab -e

# Eintrag hinzufuegen:
0 2 * * * pg_dump -U mantis mantis | gzip > /var/lib/mantis/backups/db_$(date +\%Y\%m\%d).sql.gz

sudo -u postgres psql -c "CREATE DATABASE mantis_restoretest OWNER mantis;"
gunzip -c /var/lib/mantis/backups/db_JJJJMMTT.sql.gz | psql -U mantis mantis_restoretest
sudo -u postgres psql -c "DROP DATABASE mantis_restoretest;"

Checkliste: Stabiler Dauerbetrieb