guides://search — Support-Center

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.

guides://quick-start

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 →
guides://quick-start — 5 Anleitungen · zum Lesen aufklappen
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:

  1. 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“).
  2. Ändern Sie sofort das Startpasswort und das VNC-Passwort (Schritte siehe „Zugangsdaten ändern“) – das Startpasswort wird nur dieses eine Mal verwendet.
  3. 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
  1. Führen Sie nach dem SSH-Login passwd aus und geben Sie dem Prompt folgend altes und neues Passwort ein, um das Systemkonto-Passwort zu ändern.
  2. 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.
  3. Fügen Sie Ihren lokalen öffentlichen Schlüssel zur Datei ~/.ssh/authorized_keys auf der Maschine hinzu – danach ist ein passwortloser Login möglich. Sobald der Schlüssel funktioniert, empfiehlt es sich, die Passwort-Anmeldung in sshd_config zu deaktivieren.
terminal — passwd
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
  1. Öffnen Sie Ihr lokales Terminal (unter Windows funktioniert PowerShell oder Windows Terminal gleichermaßen) und führen Sie ssh Benutzername@Node-IP aus.
  2. Bei der ersten Verbindung werden Sie zur Bestätigung des Host-Fingerprints aufgefordert – geben Sie yes ein und drücken Sie Enter. Der Fingerprint wird dann lokal in known_hosts gespeichert und beim nächsten Mal nicht mehr abgefragt.
  3. 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.
terminal — ssh
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
  1. 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.
  2. Installieren Sie lokal einen beliebigen Standard-VNC-Client und geben Sie als Adresse Node-IP:VNC-Port ein (der Port steht in der E-Mail mit den Zugangsdaten); als Passwort verwenden Sie das VNC-Passwort.
  3. 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.
  4. macOS-Nutzer können auch direkt im Finder ⌘K drücken und vnc://Node-IP eingeben, 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
  1. Legen Sie in den Einstellungen Ihres Code-Hosting-Repositorys einen neuen self-hosted Runner an und notieren Sie sich das Registrierungstoken.
  2. Loggen Sie sich per SSH auf dem Cloud-Mac ein, laden Sie das Runner-Paket herunter und führen Sie zur Registrierung config.sh aus. Für die Labels empfiehlt sich das Schema „Betriebssystem + Chip + Verwendungszweck“, damit Workflows gezielt zugewiesen werden können.
  3. Richten Sie mit svc.sh einen dauerhaften Dienst ein (basiert intern auf launchd) – nach einem Neustart der Maschine geht der Runner automatisch wieder online.
terminal — runner
./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“ →

guides://glossary

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.

glossary://terms — 7 entries
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.
troubleshoot://checklist

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.

troubleshoot://common — 4 häufige Problemtypen
SSH-Verbindung fehlgeschlagen: Timeout oder Verweigerung
  1. Zuerst ping Node-IP ausfü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.
  2. 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.
  3. Bei „Permission denied“: Prüfen Sie die Schreibweise des Benutzernamens, stellen Sie sicher, dass Ihr lokaler privater Schlüssel die Rechte chmod 600 hat, und vergewissern Sie sich, dass der öffentliche Schlüssel noch in authorized_keys auf der Maschine steht.
  4. 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.
  5. Bleibt die Verbindung weiterhin gestört: Reichen Sie ein Ticket mit der vollständigen Ausgabe von ssh -v Node-IP ein – das beschleunigt die Fehlersuche deutlich.
VNC schwarzer Bildschirm: Verbindung steht, aber kein Desktop sichtbar
  1. 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.
  2. Führen Sie per SSH sudo launchctl kickstart -k system/com.apple.screensharing aus, um den Bildschirmfreigabe-Dienst neu zu starten, und verbinden Sie sich erneut.
  3. 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.
  4. 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.
  5. 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
  1. Loggen Sie sich per SSH ein und führen Sie im Runner-Verzeichnis ./svc.sh status aus, um zu prüfen, ob der Dienst läuft; ist er gestoppt, starten Sie ihn mit ./svc.sh start.
  2. Sehen Sie im Verzeichnis _diag die neueste Logdatei durch und suchen Sie nach dem Schlüsselwort „error“ – die meisten Ursachen für Verbindungsabbrüche stehen dort klar beschrieben.
  3. Weist das Log auf einen Authentifizierungsfehler hin: Das Registrierungstoken ist abgelaufen. Führen Sie ./config.sh remove aus und registrieren Sie mit einem neuen Token erneut.
  4. 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.
  5. Vergewissern Sie sich, dass Sie den Dienst über svc.sh als dauerhaften Dienst eingerichtet haben und nicht im Vordergrund über run.sh laufen lassen – bei der Vordergrund-Methode endet der Prozess, sobald die SSH-Verbindung getrennt wird.
macOS neu installieren: System auf Werkszustand zurücksetzen
  1. 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.
  2. 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.
  3. 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.
  4. Eine Neuinstallation gilt als vom Kunden veranlasste Aktion; der Abrechnungszeitraum läuft normal weiter, es wird keine zusätzliche Zeit gutgeschrieben.
billing://faq

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.

USDT·TRC20 VISA AMEX stripe
ticket://sla

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 erstellen

E-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.com

Vier 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.

Komplexeres Problem? Zu „Wen kann ich fragen“ →
status://nodes

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.

status://nodes — 4/4 online
SingapurSG-01 · Singapore
online
Japan (Tokio)JP-01 · Tokyo
online
Südkorea (Seoul)KR-01 · Seoul
online
HongkongHK-01 · Hong Kong
online

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.

changelog://recent

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.

Blog öffnen und alle Updates ansehen →