Zum Inhalt

Self-hosted mit dem Scalio Installer

Der Scalio Installer betreibt die Scalio-Apps auf einem eigenen Linux-Server: im eigenen Rechenzentrum, auf Hyper-V, VMware oder Proxmox oder bei einem Cloud-Anbieter. Ein Server kann mehrere Apps tragen. Der Installer installiert, aktualisiert und sichert sie; alles geschieht im Browser.

Gilt für: Self-hosted

Bei SaaS betreibt Scalio die App für Sie, diese Seite können Sie überspringen.

So funktioniert es

  • Der Installer ist ein Container auf Ihrem Server. Daneben läuft Caddy, ein Webserver, der jeder App ihre Adresse mit Zertifikat gibt.
  • Jede App läuft in eigenen Containern mit eigener Datenbank. Die Apps haben keinen Zugriff auf Docker und keinen Port auf dem Server; nur Caddy antwortet auf den Ports 80 und 443.
  • Der Installer lädt die Apps aus einer Liste, die Scalio signiert. Er prüft die Signatur und lädt jedes Image über seine Prüfsumme, so kann niemand ein verändertes Image unterschieben.
  • Scalio hat keinen Zugriff auf Ihren Server. Es gibt keinen Fernzugang, kein Scalio-Konto und keinen SSH-Schlüssel von Scalio. Die Verantwortung für den Server bleibt bei Ihnen: Betriebssystem, Firewall, Überwachung und das Ziel der Sicherung.

Was Sie brauchen

Eine App Jede weitere App
Prozessoren (vCPU) 2 4 insgesamt ab drei Apps
Arbeitsspeicher (RAM) 4 GB +1 bis 2 GB
Festplatte 40 GB +10 GB, dazu Ihre Daten
  • Betriebssystem: Ubuntu Server 24.04 oder 26.04 LTS oder Debian 12 oder 13, 64 Bit (x86_64 oder arm64). Mit unserem ISO oder VM-Image erhalten Sie Ubuntu 26.04 LTS fertig eingerichtet.
  • Netzwerk: eine feste Adresse. Ports 80 und 443 für die Benutzer erreichbar (und aus dem Internet, wenn Sie Let's Encrypt ohne DNS verwenden). Ausgehend HTTPS ins Internet für Images, Updates und Microsoft.
  • Adressen (DNS): ein Name pro App, zum Beispiel nexus.firma.ch, der auf den Server zeigt. Optional ein weiterer Name für den Installer selbst, zum Beispiel setup.firma.ch.
  • E-Mail (optional): ein SMTP-Postfach, über das die Apps Einladungen und Alarme versenden.

Was der Server kostet, hängt von Ihrer Plattform ab. Eine VM dieser Grösse ist bei jedem Cloud-Anbieter ein kleiner Server; auf Ihrem eigenen Hyper-V-, VMware- oder Proxmox-Host braucht sie nur die Ressourcen oben.

Installieren

Wählen Sie einen von drei Wegen. Alle drei enden beim selben Installer.

Auf einem frischen Ubuntu- oder Debian-Server, als Benutzer mit sudo-Rechten:

curl -fsSL https://get.scaliocloud.com | sudo bash

Das Script installiert Docker aus dem offiziellen Docker-Repository, legt /opt/scalio an, öffnet die Ports 80 und 443, wenn die Firewall ufw aktiv ist, schaltet die automatischen Sicherheitsupdates ein und startet den Installer. Sonst ändert es nichts am Server.

Laden Sie das Scalio-ISO herunter und prüfen Sie es (sha256sum -c SHA256SUMS). Starten Sie eine neue VM oder einen Server davon. Die Installation fragt nur nach Sprache und Tastatur, Netzwerk, Ihrem Administrator-Konto und SSH. Es gibt kein Standardkonto und kein Standardpasswort. Das ISO nimmt die ganze erste Platte und schaltet die Firewall (22, 80, 443) und die automatischen Sicherheitsupdates ein.

Laden Sie das Image für Ihre Plattform herunter und prüfen Sie es mit seiner .sha256-Datei:

  • Hyper-V: .vhdx.zip. Entpacken und eine VM der Generation 2 mit dieser Platte anlegen, 2 vCPU und 4 GB RAM. Ist Secure Boot eingeschaltet, die Vorlage Microsoft UEFI Certificate Authority wählen.
  • VMware, VirtualBox, Proxmox: .ova. Importieren; sie bringt 2 vCPU, 4 GB RAM und 40 GB Platte mit.
  • Proxmox, KVM: .qcow2. Als Platte einer neuen VM importieren.

Beim ersten Start fragt die Konsole nach Tastatur, Benutzername und Passwort (mindestens 12 Zeichen) und optional nach Ihren SSH-Schlüsseln von GitHub. Mit cloud-init (Proxmox, VMware vApp, Azure) gilt das Konto aus cloud-init, und die Konsole fragt nicht.

Ist der Server bereit, zeigen die Konsole und jede SSH-Anmeldung die Adresse des Installers und einen Einmal-Code. Auf ISO und VM-Image zeigt sudo scalio-code jederzeit einen neuen Code (einmal gültig, 30 Minuten). Nach dem Script steht der Code in seiner Ausgabe.

Der Einrichtungsassistent

Öffnen Sie die Adresse im Browser (https://<IP des Servers>). Der Browser warnt beim ersten Mal vor dem Zertifikat, weil die IP-Adresse ein Zertifikat der eigenen Zertifizierungsstelle des Installers hat. Melden Sie sich mit dem Einmal-Code an. Der Assistent fragt danach:

  1. Sprache des Installers.
  2. Apps, die auf diesem Server laufen sollen.
  3. Adressen: den Namen jeder App und ihr Zertifikat (siehe Zertifikate).
  4. Lizenz: mit einem Gerätecode bei Scalio Compass anmelden und eine Lizenz wählen, einen Lizenzschlüssel eingeben oder ohne Lizenz weiterfahren (Gratisversion oder Testphase, je nach App).
  5. E-Mail: den Absender für alle Apps (optional, auch später möglich).
  6. Installieren: Der Installer lädt die signierten Images und startet die Apps.
  7. Notfallblatt: herunterladen und sicher aufbewahren. Es enthält die Schlüssel jeder App; ohne das Notfallblatt lässt sich eine Sicherung auf einem neuen Server nicht wiederherstellen. Der Assistent schliesst erst ab, wenn Sie es gesichert haben.

Danach zeigt die Übersicht den Setup-Code jeder App (Symbol Setup-Code im Tab Apps). Damit legen Sie in der App den ersten Administrator an. Danach nimmt die App den Code nicht mehr an.

Zertifikate

Jede App und der Installer selbst können eine von vier Arten von Zertifikat verwenden:

Art Wann
Let's Encrypt Der Name ist aus dem Internet auf Port 80 oder 443 erreichbar. Kostenlos, wird automatisch erneuert.
Let's Encrypt über DNS Interne Namen. Der Installer beweist den Namen über Ihren DNS-Anbieter und braucht ein API-Token mit Rechten für die DNS-Zone. Unterstützt: Cloudflare, Amazon Route 53, Azure DNS, deSEC, DigitalOcean, Gandi, GoDaddy, Hetzner, Infomaniak, IONOS, Namecheap, netcup, OVHcloud, Porkbun und weitere.
Interne Zertifizierungsstelle Kein Internet, kein DNS-Anbieter. Jedes Gerät muss dem Root-Zertifikat vertrauen (Root-Zertifikat herunterladen im Tab Apps).
Eigenes Zertifikat Ein Zertifikat Ihrer Firma (PEM-Datei mit Kette und privater Schlüssel ohne Passwort).

Das Zertifikat einer App ändern Sie mit dem Schild-Symbol im Tab Apps.

Im Alltag

Der Installer hat drei Tabs:

  • Übersicht: verfügbare Updates, die Apps auf einen Blick und der Zustand des Servers (Speicherplatz, Arbeitsspeicher, Last, Container).
  • Apps: eine Zeile pro App. Die Symbole starten, stoppen und starten die App neu und ändern Zertifikat, Lizenz, Setup-Code und Vorabversionen; der Papierkorb deinstalliert sie. Weitere Apps installieren fügt jederzeit Apps hinzu.
  • Einstellungen: Sicherung, Updates des Servers, Support, Adresse des Installers, Konten und Alarme.

Updates der Apps

Der Installer prüft auf neue Versionen und zeigt sie in der Übersicht. Auf … aktualisieren sichert zuerst die Datenbank der App und wechselt dann auf die neue Version; die Datenbank geht nie auf eine ältere Version zurück. Arbeitet die App gerade (zum Beispiel ein langer Auftrag), wartet der Installer und fragt, bevor er trotzdem aktualisiert. Mit Vorabversionen anzeigen pro App erhalten Sie auch Release Candidates (siehe Vorabversionen).

Den Installer selbst aktualisieren Sie mit sudo scalio-update auf dem Server (ISO und VM-Image) oder indem Sie das Script nochmals ausführen. Die Apps und ihre Daten bleiben, wie sie sind.

Sicherung

Unter Einstellungen → Sicherung wählen Sie ein Ziel: nur auf diesem Server, S3 (Amazon, Wasabi, MinIO, Infomaniak …), Azure Blob Storage, SFTP oder eine Windows-Freigabe (SMB). Jede Nacht sichert der Installer Datenbank und Dateien jeder App, verschlüsselt mit Ihrem Sicherungspasswort. Ohne das Passwort kann niemand eine Sicherung öffnen, auch Scalio nicht: Bewahren Sie es beim Notfallblatt auf. In der ersten Nacht jedes Monats stellt der Installer eine Sicherung testweise wieder her und zeigt das Ergebnis; Test-Wiederherstellung jetzt startet den Test sofort.

Updates des Servers

Der Server installiert jede Nacht selbst die Sicherheitsupdates. Braucht ein Update einen Neustart, startet der Server nur in dem Fenster neu, das Sie unter Einstellungen → Updates des Servers festlegen (Tag und Stunde; oder nie, dann starten Sie selbst neu). Die Apps starten danach von selbst.

Alarme

Unter Einstellungen → Alarme per E-Mail erhalten Sie eine Mail, wenn ein Container stoppt oder «unhealthy» meldet, der Speicherplatz zu über 90 % belegt ist oder ein Zertifikat in weniger als 14 Tagen abläuft, und eine, wenn es wieder in Ordnung ist.

Zugang zum Installer

  • Adresse des Installers: ein eigener Name (zum Beispiel setup.firma.ch) mit einem der Zertifikate oben. Die IP-Adresse funktioniert weiter.
  • Konten für den Installer: Benutzername, Passwort und eine Authenticator-App (zum Beispiel Microsoft Authenticator). Der Einmal-Code vom Server funktioniert weiter, ein verlorenes Telefon sperrt Sie also nie aus.

Support

Scalio hat keinen Zugriff auf Ihren Server. Für Hilfe laden Sie unter Einstellungen → Support das Support-Paket herunter und senden es mit Ihrer Anfrage. Es enthält Versionen, Zustand und die letzten Log-Zeilen, ohne Passwörter, Schlüssel oder Lizenzen.

Eine ältere Nexus-Installation übernehmen

Läuft Scalio Nexus auf dem Server schon mit eigenem Docker Compose und Updater, findet der Installer die Installation und bietet Nexus übernehmen an. Er sichert die Datenbank, stoppt die alten Container (sie bleiben für einen Weg zurück), installiert Nexus mit denselben Daten, Secrets und derselben Lizenz und spielt die Datenbank ein. Geht etwas schief, starten die alten Container wieder wie vorher. Nexus ist dabei einige Minuten nicht erreichbar. Ändert sich die Adresse, passen Sie auch die Umleitungs-URI der Nexus-App-Registrierung in Microsoft Entra an.

Dateien auf dem Server

Pfad Inhalt
/opt/scalio/apps/<app>/ Compose-Datei und .env jeder App (die .env enthält Secrets, nur für root lesbar)
/opt/scalio/backups/ Lokale Sicherungen und die Datenbank vor jedem Update
/opt/scalio/setup/ Einstellungen des Installers

Ändern Sie diese Dateien nie von Hand; der Installer schreibt sie wieder. Um alles zu entfernen, deinstallieren Sie jede App mit Auch die Daten löschen und entfernen danach /opt/scalio.