Bei Problemen: Erst hier selbst nachschauen
> Frage eingeben oder unten im Fenster starten. Die meisten Probleme lösen sich in 5 Minuten selbst.
Keine passenden Einträge gefunden. Versuchen Sie es mit einem anderen Suchbegriff oder schreiben Sie direkt eine E-Mail an support@opsmac.com und fügen Sie die Fehlermeldung im Original bei.
Erste Schritte: Fünf Anleitungen vom Start bis zur Integration
Etwa 4 Minuten nach der Zahlung erhalten Sie Ihre Zugangsdaten per E-Mail. Arbeiten Sie die folgenden fünf Anleitungen in der angegebenen Reihenfolge durch – vom ersten Login bis zur CI-Integration brauchen Sie dabei keine zusätzliche Hilfe.
Erster Start
Was die E-Mail mit den Zugangsdaten enthält, welche drei Schritte danach zuerst folgen und wie Sie prüfen, ob die Maschine bereit ist.
Schritte ansehen →Zugangsdaten ändern
Ändern Sie nach dem ersten Login sofort das Startpasswort und das VNC-Passwort und wechseln Sie zur Anmeldung per Schlüssel.
Schritte ansehen →Erste SSH-Verbindung
Mit einem einzigen Befehl auf Ihren dedizierten physischen Server einloggen – inklusive Fingerprint-Bestätigung und passwortloser Konfiguration.
Schritte ansehen →VNC-Remote-Desktop
Die grafische macOS-Oberfläche öffnen: Bildschirmfreigabe aktivieren, Client-Parameter und Auflösungsempfehlungen.
Schritte ansehen →Self-hosted Runner einbinden
CI-Build-Jobs an diese Maschine weiterleiten: Registrieren, Labels vergeben, als Dienst dauerhaft einrichten.
Schritte ansehen →Erster Start: Die ersten 5 Minuten nach der Zugangsdaten-E-Mail
Nach der Zahlungsbestätigung weist das System automatisch einen dedizierten physischen Mac mini zu und initialisiert macOS. Die E-Mail mit den Zugangsdaten trifft in der Regel innerhalb von etwa 4 Minuten ein und enthält: Node-IP, Systembenutzername, Startpasswort und VNC-Port. Erledigen Sie danach diese drei Schritte in dieser Reihenfolge:
- Loggen Sie sich einmal per SSH mit der IP und dem Konto aus der E-Mail ein, um zu bestätigen, dass die Maschine online und das Konto nutzbar ist (Befehl siehe unten unter „Erste SSH-Verbindung“).
- Ändern Sie sofort das Startpasswort und das VNC-Passwort (Schritte siehe „Zugangsdaten ändern“) – das Startpasswort wird nur dieses eine Mal verwendet.
- Bestätigen Sie im Kundenportal, dass der Instanzstatus „Aktiv“ anzeigt, und prüfen Sie, ob Node und Modell mit Ihrer Bestellung übereinstimmen.
Bei Auslieferung sind Xcode und die gängigen Kommandozeilen-Tools bereits vorinstalliert. Die grafische macOS-Oberfläche und die Kommandozeile stehen vollständig zur Verfügung, ohne dass zusätzliche Aktivierungsschritte nötig sind.
Zugangsdaten ändern: Startpasswort ersetzen, auf Schlüssel umstellen
- Führen Sie nach dem SSH-Login
passwdaus und geben Sie dem Prompt folgend altes und neues Passwort ein, um das Systemkonto-Passwort zu ändern. - Das VNC-Passwort wird separat geändert: Öffnen Sie in der grafischen Oberfläche „Systemeinstellungen → Allgemein → Freigabe → Bildschirmfreigabe“ und aktualisieren Sie das Zugriffspasswort in den Optionen.
- Fügen Sie Ihren lokalen öffentlichen Schlüssel zur Datei
~/.ssh/authorized_keysauf der Maschine hinzu – danach ist ein passwortloser Login möglich. Sobald der Schlüssel funktioniert, empfiehlt es sich, die Passwort-Anmeldung insshd_configzu deaktivieren.
passwd Changing password for opsmac. Old Password: ******** New Password: ************ passwd: password updated successfully
Dieses Gerät ist ein dedizierter physischer Server – die Zugangsdaten werden ausschließlich an Sie ausgegeben. Die Verantwortung für die sichere Aufbewahrung liegt beim Kunden; sollten Zugangsdaten kompromittiert werden, ändern Sie bitte umgehend das Passwort und reichen Sie ein Support-Ticket ein.
Erste SSH-Verbindung: Mit einem Befehl auf Ihren Mac einloggen
- Öffnen Sie Ihr lokales Terminal (unter Windows funktioniert PowerShell oder Windows Terminal gleichermaßen) und führen Sie
ssh Benutzername@Node-IPaus. - Bei der ersten Verbindung werden Sie zur Bestätigung des Host-Fingerprints aufgefordert – geben Sie
yesein und drücken Sie Enter. Der Fingerprint wird dann lokal in known_hosts gespeichert und beim nächsten Mal nicht mehr abgefragt. - Geben Sie das Startpasswort aus der E-Mail ein. Sobald der Shell-Prompt erscheint, war der Login erfolgreich. Wechseln Sie anschließend gemäß „Zugangsdaten ändern“ auf einen Schlüssel.
ssh opsmac@203.0.113.24 The authenticity of host '203.0.113.24' can't be established. Are you sure you want to continue connecting (yes/no)? yes opsmac@mini-sg-01 ~ %
Die vollständige Anleitung zum Hochladen von Schlüsseln, zur Sicherheitshärtung und zur Einschränkung erlaubter Quell-IPs finden Sie in der Schritt-für-Schritt-Anleitung auf der Seite „Wie stelle ich die Verbindung her“ →
VNC-Remote-Desktop: Die grafische macOS-Oberfläche öffnen
- Bei Auslieferung ist die Bildschirmfreigabe standardmäßig aktiviert. Falls sie deaktiviert wurde, können Sie sich per SSH einloggen und sie unter „Systemeinstellungen → Allgemein → Freigabe“ wieder aktivieren.
- Installieren Sie lokal einen beliebigen Standard-VNC-Client und geben Sie als Adresse
Node-IP:VNC-Portein (der Port steht in der E-Mail mit den Zugangsdaten); als Passwort verwenden Sie das VNC-Passwort. - Empfohlene Auflösung: 1920×1080, Farbqualität zunächst auf „Mittel“ setzen. Bei internationalen Verbindungen zunächst auf Flüssigkeit statt Bildqualität achten und erst danach nach Bedarf höher stellen.
- macOS-Nutzer können auch direkt im Finder ⌘K drücken und
vnc://Node-IPeingeben, um sich über die systemeigene Bildschirmfreigabe zu verbinden.
Grafische Oberfläche und Kommandozeile lassen sich gleichzeitig nutzen: Xcode-Bedienung läuft über VNC, Build-Skripte über SSH – beide beeinflussen sich nicht gegenseitig.
Self-hosted Runner einbinden: In drei Schritten in den CI-Pool
- Legen Sie in den Einstellungen Ihres Code-Hosting-Repositorys einen neuen self-hosted Runner an und notieren Sie sich das Registrierungstoken.
- Loggen Sie sich per SSH auf dem Cloud-Mac ein, laden Sie das Runner-Paket herunter und führen Sie zur Registrierung
config.shaus. Für die Labels empfiehlt sich das Schema „Betriebssystem + Chip + Verwendungszweck“, damit Workflows gezielt zugewiesen werden können. - Richten Sie mit
svc.sheinen dauerhaften Dienst ein (basiert intern auf launchd) – nach einem Neustart der Maschine geht der Runner automatisch wieder online.
./config.sh --url Ihre-Repository-URL --token Registrierungstoken --labels macos,m4,selfhosted ./svc.sh install && ./svc.sh start √ Connected to server. Listening for Jobs
Empfehlung zur Nebenläufigkeit: Die M4-Home-Variante (16 GB) läuft am stabilsten mit einem einzelnen Job gleichzeitig; für mehrere parallele Jobs empfiehlt sich die M4-Pro-Workstation-Variante mit 64 GB. Details zur Dienst-Konfiguration finden Sie auf der Seite „Wie stelle ich die Verbindung her“ →
Kleines Glossar: 7 Begriffe, mit denen die Produktseite klar wird
Diese Begriffe tauchen auf der Produktseite und in Rechnungen immer wieder auf – jeder wird in zwei Sätzen erklärt. Wenn Sie diese verstehen, treffen Sie bei der Auswahl kaum noch Fehlentscheidungen.
- Physischer Node node
- Ein reales Mac-mini-Gerät, das in einem Rechenzentrums-Rack steht. Sie mieten diese Maschine selbst – nicht einen kleinen, herausgeschnittenen Teil davon.
- Dediziert dedicated
- Während der Mietdauer gehören CPU, Unified Memory, SSD und Bandbreite der gesamten Maschine ausschließlich Ihnen – ohne Mitbewohner, die um Ressourcen konkurrieren. Build-Zeiten sind dadurch vorhersehbar.
- Nicht virtualisiert non-virtualized
- macOS läuft direkt auf Apple-Silicon-Hardware, ohne Virtualisierungsschicht dazwischen. Kein Leistungsverlust – die Build-Zeit in Xcode entspricht der echten Hardware-Zeit.
- VNC screen sharing
- Ein von macOS nativ unterstütztes Protokoll für grafischen Remote-Desktop. Mit einem beliebigen Standard-VNC-Client bedienen Sie den gesamten Desktop, als säßen Sie direkt vor der Maschine.
- Self-hosted Runner CI
- Ein selbst gehosteter CI-Executor. Sobald er auf Ihrem Cloud-Mac registriert ist, werden Build-Jobs von Plattformen wie GitHub Actions auf diesem dedizierten physischen Server ausgeführt.
- Unified Memory unified memory
- CPU und GPU der Apple Silicon teilen sich denselben Speicher mit hoher Bandbreite. Ein 64-GB-Modell kann direkt ein mittelgroßes MLX-Inferenzmodell aufnehmen.
- TestFlight Beta-Verteilung
- Apples offizielles Tool zur Verteilung von Testversionen. Nachdem Sie mit fastlane auf dem Cloud-Mac einen Build erstellt haben, laden Sie ihn direkt zu TestFlight hoch, damit Tester ihn installieren können.
Fehlerbehebung: Erst die Checkliste, dann das Ticket
Für die vier häufigsten Problemtypen gibt es jeweils eine Checkliste zum Durcharbeiten. Erfahrungsgemäß ist ein Problem in 80 % der Fälle gelöst, bevor der letzte Schritt überhaupt nötig wird.
SSH-Verbindung fehlgeschlagen: Timeout oder Verweigerung
- Zuerst
ping Node-IPausführen. Alle vier Nodes sind ganzjährig online – kein Ping-Erfolg deutet meist auf Ihr lokales Netzwerk oder Ausgangsbeschränkungen hin. Probieren Sie eine andere Netzwerkumgebung. - Port testen:
nc -vz Node-IP 22. Ist der Port nicht erreichbar, obwohl der Ping funktioniert, prüfen Sie, ob Sie den sshd-Port oder Firewall-Regeln geändert haben. - Bei „Permission denied“: Prüfen Sie die Schreibweise des Benutzernamens, stellen Sie sicher, dass Ihr lokaler privater Schlüssel die Rechte
chmod 600hat, und vergewissern Sie sich, dass der öffentliche Schlüssel noch in authorized_keys auf der Maschine steht. - Prüfen Sie im Kundenportal den Instanzstatus; bei einer Auffälligkeit können Sie direkt im Portal einen Neustart auslösen – die Wiederherstellung dauert etwa 1 Minute.
- Bleibt die Verbindung weiterhin gestört: Reichen Sie ein Ticket mit der vollständigen Ausgabe von
ssh -v Node-IPein – das beschleunigt die Fehlersuche deutlich.
VNC schwarzer Bildschirm: Verbindung steht, aber kein Desktop sichtbar
- Prüfen Sie zunächst, ob der SSH-Login funktioniert – wenn ja, ist die Maschine online und das Problem liegt allein bei der Anzeige-Ebene.
- Führen Sie per SSH
sudo launchctl kickstart -k system/com.apple.screensharingaus, um den Bildschirmfreigabe-Dienst neu zu starten, und verbinden Sie sich erneut. - Schwarzer Bildschirm, aber Mauszeiger sichtbar: In den meisten Fällen befindet sich der Bildschirm im Sperrbildschirm – geben Sie einfach das Kontopasswort ein und drücken Sie Enter, um zum Desktop zu gelangen.
- Bild flimmert oder baut sich extrem langsam auf: Reduzieren Sie die Farbqualität im Client und setzen Sie die Auflösung auf 1920×1080 herab.
- Testen Sie zum Vergleich einen anderen Client (die systemeigene Bildschirmfreigabe von macOS oder einen beliebigen Standard-VNC-Client); bleibt es bei beiden schwarz, reichen Sie ein Ticket ein und geben Sie an, welches Ergebnis der Neustart des Dienstes brachte.
Runner offline: CI-Plattform zeigt „offline“ an
- Loggen Sie sich per SSH ein und führen Sie im Runner-Verzeichnis
./svc.sh statusaus, um zu prüfen, ob der Dienst läuft; ist er gestoppt, starten Sie ihn mit./svc.sh start. - Sehen Sie im Verzeichnis
_diagdie neueste Logdatei durch und suchen Sie nach dem Schlüsselwort „error“ – die meisten Ursachen für Verbindungsabbrüche stehen dort klar beschrieben. - Weist das Log auf einen Authentifizierungsfehler hin: Das Registrierungstoken ist abgelaufen. Führen Sie
./config.sh removeaus und registrieren Sie mit einem neuen Token erneut. - Bricht ein Job mitten in der Ausführung ab: Prüfen Sie, ob parallel laufende Jobs den Arbeitsspeicher ausgeschöpft haben. Für das 16-GB-Modell wird nur ein Job gleichzeitig empfohlen; für dauerhaft parallele Jobs verwenden Sie die M4-Pro-Workstation-Variante mit 64 GB.
- Vergewissern Sie sich, dass Sie den Dienst über
svc.shals dauerhaften Dienst eingerichtet haben und nicht im Vordergrund überrun.shlaufen lassen – bei der Vordergrund-Methode endet der Prozess, sobald die SSH-Verbindung getrennt wird.
macOS neu installieren: System auf Werkszustand zurücksetzen
- Bei einer Neuinstallation werden sämtliche Daten auf der Maschine gelöscht. Sichern Sie zuvor Build-Artefakte, Zertifikate und Konfigurationen auf Ihrem eigenen Speicher – die Verantwortung für die Datensicherung liegt beim Kunden.
- Reichen Sie im Kundenportal ein Ticket „macOS neu installieren“ ein und geben Sie Bestellnummer und Node an; eine zusätzliche E-Mail ist nicht erforderlich.
- Während der Neuinstallation ist die Instanz vorübergehend nicht verfügbar; nach Abschluss werden die neuen Zugangsdaten automatisch per E-Mail zugestellt – initialisieren Sie die Maschine dann gemäß „Erster Start“ neu.
- Eine Neuinstallation gilt als vom Kunden veranlasste Aktion; der Abrechnungszeitraum läuft normal weiter, es wird keine zusätzliche Zeit gutgeschrieben.
Abrechnung und Rechnung: Wartezeit bis zur Aktivierung und wie man die Rechnung liest
Alle Preise werden in US-Dollar angegeben, mit vier Abrechnungszeiträumen (Tag/Woche/Monat/Quartal); Zusatzoptionen werden synchron mit dem Hauptzeitraum abgerechnet. Hier klären wir nur die zwei Fragen, die im Support am häufigsten gestellt werden.
Verstehen Sie die einzelnen Rechnungsposten nicht?
Auf der Seite „Was kostet das“ finden Sie eine Beispielrechnung mit Zeile-für-Zeile-Erklärung (Rechnungsaufschlüsselung): Zeitraum, Node, Zusatzposten, Summe – jeder Posten sowie die Logik zu Verlängerung und Ablauf sind direkt daneben vermerkt. Beispiel: M4-Home-Variante monatlich $97,10, Zusatzoption 1 TB SSD monatlich $14,10 – jeweils als eigene Zeile ausgewiesen.
Rechnungsaufschlüsselung ansehen →Bezahlt – wie lange dauert die Aktivierung?
Bei Kartenzahlung (Visa / Mastercard / Amex, über Stripe) erfolgt die Bestätigung sofort nach Autorisierung; bei USDT-TRC20 ist die Bestätigung auf der Blockchain abzuwarten, üblicherweise 1–3 Minuten. Sobald eine der beiden Zahlungsarten bestätigt ist, weist das System automatisch eine Maschine zu – von der Zahlung bis zur Zustellung der Zugangsdaten dauert es insgesamt etwa 4 Minuten. Ist nach 15 Minuten noch keine Aktivierung erfolgt, reichen Sie ein Ticket mit Transaktions-Hash oder Zahlungsbeleg ein.
Vollständige Preisliste ansehen →Wir akzeptieren ausschließlich USDT-TRC20 sowie Visa / Mastercard / Amex (über Stripe), alle Beträge werden in US-Dollar (USD) abgerechnet; welche Zahlungswege tatsächlich verfügbar sind, richtet sich nach der Rückmeldung der Schnittstelle zum Zeitpunkt der Bestellung.
Support-Tickets und Reaktionszeiten: Vor dem Kontakt Informationen bereithalten
Hat die Checkliste das Problem nicht gelöst, ist es Zeit, sich an uns zu wenden. Es gibt nur zwei Kanäle – halten Sie die nötigen Informationen von Anfang an bereit, meist ist keine weitere Nachfrage erforderlich.
Support-Ticket im Kundenportal (empfohlen)
Reichen Sie ein Ticket im Kundenportal ein – es wird automatisch mit Ihrer Bestellung und Instanz verknüpft und am schnellsten bearbeitet. Die meisten Tickets erhalten innerhalb weniger Stunden eine erste Antwort und innerhalb von 24 Stunden eine Lösung.
Im Kundenportal einloggen und Ticket erstellenE-Mail: support@opsmac.com
Geeignet für Fragen vor dem Kauf oder wenn Sie sich nicht ins Kundenportal einloggen können und deshalb kein Ticket erstellen können – Antwort innerhalb von 24 Stunden. Geben Sie einen klaren Betreff an und fügen Sie die Fehlermeldung im Original direkt in den Text ein.
support@opsmac.comVier Angaben vor dem Absenden bereithalten
Node (z. B. Tokio), Modell (M4-Home-Variante / M4-Pro-Workstation-Variante), Bestellnummer, Problembeschreibung und Schritte zur Reproduktion. Falls vorhanden, fügen Sie Logdateien oder die Ausgabe von ssh -v bei.
Systemankündigungen: Node-Status und Störungsmeldungen
Dieselbe Angabe wie im Benachrichtigungscenter auf der Startseite: Alle vier physischen Nodes sind online, ganzjährig ohne geplante Offline-Zeiten.
365 Tage im Jahr verfügbar. Kommt es zu einer Hardware- oder Netzwerkstörung, informieren wir per E-Mail und über ein Banner im Kundenportal laufend über den Fortschritt und gleichen die betroffene Mietdauer nach dem Prinzip „ausgefallene Zeit wird gutgeschrieben“ aus – die genauen Bedingungen finden Sie unter Was sind die Regeln.
Letzte Aktualisierungen: Praxis-Tutorials und Notizen zur Modellauswahl
Ausführlichere Beiträge über die Anleitungen hinaus finden Sie im Blog: nach Monat archiviert, Tutorials mit gemessenen Laufzeiten. Hier die Updates der letzten drei Monate.
Kontotrennung, Zeitplanung für die Bildschirmfreigabe, versetzte Build-Jobs – und warum ein dedizierter physischer Server für diesen Einsatzzweck besser geeignet ist.
Kompatibilitätstests für eine neue iOS-Version: Der schnellste Weg mit einem für eine Woche gemieteten Cloud-MacIm Kompatibilitätsfenster mit einem wöchentlich abgerechneten M4 die aktuellste Xcode-Version installieren und die Regressionstests durchlaufen, ohne die lokale Entwicklungsumgebung zu unterbrechen.
CI/CD-Pipeline an einen Cloud-Mac anbinden: Self-hosted Runner Schritt für SchrittLabel-Design, Steuerung der Nebenläufigkeit, Caching-Strategien und Konfiguration als dauerhafter Dienst – mit einem Vergleich der Build-Zeiten gegenüber gemeinsam genutzten virtuellen Maschinen.
Von der Zertifikatsverwaltung mit match über den Build mit gym bis zum Upload zu TestFlight – mit einer Checkliste für häufige Signierungsfehler.
Für welche Teams sich ein tageweise abgerechneter Cloud-Mac wirklich lohntDie vier Abrechnungszeiträume werden mit realen Team-Profilen abgeglichen, inklusive einer Entscheidungsgrafik, die zeigt, welcher Zeitraum das Budget am wenigsten belastet.