The-Y CRM · Anleitung

The-Y CRM auf deinem eigenen Server

Ein Befehl, keine Konfigurationsdateien. Der Installer erzeugt alle Passwörter selbst, erkennt deine Server-Umgebung und richtet alles ein. Den Lizenzschlüssel gibst du danach bequem in der App ein.

Was du brauchst

Einen Linux-Server (Root/SSH-Zugang). Schon ~2 CPU / 4 GB RAM / 40 GB SSD reichen für den Start.
Docker & Docker Compose (Schritt 1 zeigt die Installation, falls noch nicht vorhanden).
Eine Domain (z. B. crm.deine-firma.at), deren DNS auf den Server zeigt.
Deinen Lizenzschlüssel aus der Founder-Willkommensmail (oder von the-y.at).

→ Welchen Server brauche ich? — Größen-Empfehlung (klein/mittel/groß), Ports & Architektur im Detail.

Docker installieren (falls noch nicht vorhanden)

Prüfe mit docker version. Fehlt Docker, installiere es mit dem offiziellen Skript:
```
curl -fsSL https://get.docker.com | sh
```
Auf Servern mit Panel (Plesk/cPanel/Virtualmin) ist Docker oft schon vorhanden oder per Ein-Klick nachrüstbar.
Domain auf den Server zeigen lassen

Setze bei deinem Domain-Anbieter einen A-Record für deine Domain (z. B. crm.deine-firma.at) auf die IP-Adresse deines Servers. Das kann ein paar Minuten dauern, bis es überall aktiv ist.
Installer ausführen

Ein einziger Befehl auf dem Server (als Root bzw. mit einem Nutzer in der docker-Gruppe):
```
curl -fsSL https://the-y.at/install.sh -o install.sh && bash install.sh
```
Der Installer fragt nur nach Domain, Admin-E-Mail, (optional) Passwort und Firmenname — und erledigt dann alles: generiert sämtliche Passwörter, richtet Datenbank + ersten Admin ein und erkennt automatisch, ob auf deinem Server schon ein Webserver läuft. Je nachdem geht es bei einem der drei Fälle unten weiter.

Je nach Server — einer dieser drei Fälle

Fall A

🟢 Frischer Server

Nichts läuft auf Port 80/443. Der Installer bringt sein eigenes HTTPS mit (holt automatisch ein Let's-Encrypt-Zertifikat).

Du musst nichts weiter tun — öffne einfach deine Domain im Browser. Falls die Seite kurz nicht lädt: DNS/Ports 80+443 prüfen.

Fall B

🧩 Server mit Panel

Virtualmin, Plesk oder cPanel belegen 80/443 bereits. Der Installer schaltet automatisch in den Proxy-Modus (App lauscht lokal auf 127.0.0.1:8090).

Lege im Panel für deine Domain einen Reverse Proxy / Proxy-Pass an, Ziel:

http://127.0.0.1:8090

und aktiviere für die Domain HTTPS/Let's Encrypt im Panel. Fertig.

Fall C

⚙️ Nur Apache/Nginx

Du hast einen eigenen Webserver ohne Panel. Auch hier läuft die App auf 127.0.0.1:8090 — füge einen Reverse-Proxy-Vhost hinzu (Snippets unten) und hole ein Zertifikat mit certbot.

Nginx-Vhost (Fall C)

server {
    server_name crm.deine-firma.at;
    location / {
        proxy_pass http://127.0.0.1:8090;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-Host $host;
        proxy_set_header X-Forwarded-Proto https;
        proxy_set_header X-Real-IP $remote_addr;
    }
}
# danach:  sudo certbot --nginx -d crm.deine-firma.at

Apache-Vhost (Fall C)

<VirtualHost *:443>
    ServerName crm.deine-firma.at
    ProxyPreserveHost On
    ProxyPass        / http://127.0.0.1:8090/
    ProxyPassReverse / http://127.0.0.1:8090/
    RequestHeader set X-Forwarded-Proto "https"
    # SSLEngine + Zertifikat via certbot --apache
</VirtualHost>

Wichtig: Deine Domain muss per HTTPS ausgeliefert werden — die Anmelde-Cookies sind sicherheitshalber „secure". Über reines HTTP funktioniert der Login nicht. Panels und certbot erledigen das Zertifikat automatisch.

Letzter Schritt — Anmelden & Lizenz eingeben

Im Browser öffnen & anmelden

Rufe https://deine-domain auf und melde dich mit der Admin-E-Mail und dem Passwort an, das der Installer am Ende angezeigt hat.
Lizenzschlüssel eingeben — in der App

Der Einrichtungs-Assistent fragt beim ersten Start danach, oder du gehst zu Einstellungen → 🔑 Lizenz und trägst deinen Schlüssel ein. Keine Konfigurationsdatei nötig. Ohne Lizenz läuft die Instanz im Free-Modus mit Limits.

✅ Updates & Backups
Updates kommen automatisch (nächtlich per Watchtower); ein Banner in der App meldet neue Versionen. Du kannst auch jederzeit manuell aktualisieren:

cd ~/the-y-crm && docker compose pull && docker compose up -d

Für Backups sichere regelmäßig das Postgres- und das MinIO-Volume — ein einfacher Datenbank-Dump:

cd ~/the-y-crm && docker compose exec -T postgres \
  pg_dump -U crm crm | gzip > crm-backup-$(date +%F).sql.gz

Es hakt irgendwo?

Schreib uns einfach — antworte auf deine Founder-Willkommensmail oder melde dich über the-y.at. Wir helfen beim Aufsetzen.

The-Y CRM auf deinem eigenen Server

Docker installieren (falls noch nicht vorhanden)

Domain auf den Server zeigen lassen

Installer ausführen