1. Cloud-Server
  2. Support
04 Support

SSH-Verbindung, Xcode-Builds und Runner-Konfiguration: Support-Dokumentation zur Selbsthilfe

Schauen Sie zuerst in die Dokumentation, bevor Sie ein Ticket erstellen. Die drei häufigsten Problemfelder – Verbindung, Signierung und VNC – lassen sich meist in 10 Minuten selbst lösen. Kommen Sie nicht weiter, zeigen wir Ihnen am Ende der Seite, wie Sie ein Ticket erstellen, das unsere Techniker sofort verstehen.

Quick Start

In drei Schritten startklar

Nach der Bestellung erhalten Sie die Zugangsdaten im Schnitt nach 5 Minuten per E-Mail. Mit den folgenden drei Schritten dauert die erste Verbindung keine 3 Minuten.

01

Zugangsdaten per E-Mail erhalten

Die E-Mail enthält die Node-Adresse (z. B. hk1.oncemini.com), den SSH-Port 22, den Standardnutzer dev, das Anfangspasswort und das VNC-Passwort. Nichts erhalten? Prüfen Sie zuerst den Spam-Ordner und dann die Instanzdetails im Kundenportal.

02

Erste SSH-Anmeldung und Passwort ändern

Führen Sie ssh -p 22 dev@Node-Adresse aus und ändern Sie direkt nach der Anmeldung mit passwd das Anfangspasswort. Anschließend empfiehlt es sich, den öffentlichen Schlüssel per ssh-copy-id hochzuladen und die Passwort-Anmeldung zu deaktivieren.

03

Grafische Oberfläche per VNC verbinden

Verbinden Sie sich mit der integrierten Bildschirmfreigabe von macOS oder einem beliebigen VNC-Client zu Node-Adresse:5900. Nach Eingabe des VNC-Passworts landen Sie direkt auf dem vollständigen macOS-Desktop – hier erledigen Sie das erste Xcode-Pairing und bestätigen Systemdialoge.

Ab Übergabe haben Sie volle Root-Rechte: sudo steht jederzeit zur Verfügung, Systemkonfigurationen lassen sich beliebig anpassen. Sollte mal etwas schiefgehen – im Kundenportal können Sie macOS jederzeit selbst neu aufsetzen, siehe Anleitung unten.
Terminal

Von der Anmeldung bis zum Upload: der komplette Workflow

Im Folgenden ein echter Ausschnitt von einem Hongkong-Node Mini M (M4 / 24 GB): SSH-Login, Xcode-Build und fastlane-Upload zu App Store Connect. Die Befehle rechts lassen sich direkt kopieren.

dev@mini-hk1 — zsh — 96×28
ssh -p 22 dev@hk1.oncemini.com
Last login: Mon Jul 27 09:12:33 2026 from 203.0.113.24
sw_vers
ProductName:    macOS
ProductVersion: 15.5
BuildVersion:   24F74
xcodebuild -scheme App -configuration Release -destination 'generic/platform=iOS' build
▸ Compiling AppDelegate.swift
▸ Linking App
▸ Signing App.app
** BUILD SUCCEEDED ** [128.4s]
bundle exec fastlane release
[10:24:08] Login to App Store Connect (API key)
[10:26:41] Upload progress: 100%
Successfully uploaded package to App Store Connect
dev@mini-hk1 ~ % 

Häufige Befehle · Zum Kopieren klicken

ssh -p 22 dev@hk1.oncemini.com
passwd
ssh-copy-id -i ~/.ssh/id_ed25519.pub dev@hk1.oncemini.com
sudo xcode-select -s /Applications/Xcode_16.4.app
xcodebuild -scheme App -configuration Release build
security unlock-keychain login.keychain-db

Ersetzen Sie hk1 einfach durch Ihr Node-Präfix – alle Node-Domains finden Sie unter Serverstandorte. CI-Skripte, die lokal bei Ihnen laufen, funktionieren hier unverändert.

Guides

Anleitungen für häufige Aufgaben

Die vier am häufigsten gestellten Aufgaben – Schritt für Schritt umsetzbar. Jede Anleitung wurde auf echter Hardware getestet.

Mehrere Xcode-Versionen verwalten

  1. Das Auslieferungs-Image enthält bereits zwei stabile Xcode-Versionen, benannt nach Versionsnummer unter /Applications/Xcode_16.4.app und /Applications/Xcode_15.4.app.
  2. Aktive Version prüfen: xcodebuild -version.
  3. Global umschalten: sudo xcode-select -s /Applications/Xcode_15.4.app.
  4. In CI-Pipelines nicht global umschalten, sondern per Umgebungsvariable für den jeweiligen Lauf festlegen: DEVELOPER_DIR=/Applications/Xcode_16.4.app xcodebuild ….
  5. Für weitere Versionen (auch Betas) reicht ein Ticket mit Versionsangabe. Unsere Bibliothek deckt alle regulären Releases ab 15.0 ab und wird während der Geschäftszeiten meist innerhalb von 2 Stunden auf die Maschine gespielt.

GitHub Actions Self-Hosted Runner einrichten

  1. Im Repository unter Settings → Actions → Runners → New self-hosted runner macOS als System und ARM64 als Architektur wählen.
  2. Runner-Paket mit den angezeigten Befehlen herunterladen, entpacken und mit ./config.sh --url … --token … registrieren.
  3. Als dauerhaften Dienst registrieren: ./svc.sh install && ./svc.sh start – nach einem Neustart übernimmt launchd automatisch den Start.
  4. Im Workflow runs-on: [self-hosted, macOS, ARM64] angeben; bei mehreren Maschinen empfiehlt sich ein eigenes Label zur Unterscheidung.
  5. Richtwert für Parallelität: Ein Mini M (24 GB) läuft stabil mit 2 gleichzeitigen Jobs. Für mehr Parallelität empfiehlt sich der Mini Pro (64 GB), siehe Mietpläne.

Remote-Debugging mit echtem Gerät

  1. Befinden sich das Test-iPhone und der Cloud-Mac nicht im selben Netzwerk, verbinden Sie beide zunächst z. B. per WireGuard in dasselbe Netzsegment.
  2. Das erste Pairing erfolgt im Xcode-Fenster „Devices and Simulators“ – einmalig über die grafische VNC-Oberfläche.
  3. Beim Pairing „Netzwerk-Debugging“ aktivieren – danach lässt sich das Gerät direkt mit xcodebuild -destination 'platform=iOS,name=Gerätename' ansprechen.
  4. Für reine Unit-Tests und UI-Tests im Simulator ist kein echtes Gerät nötig – ab Übergabe sofort einsatzbereit, ganz ohne Netzwerk-Setup.

macOS neu aufsetzen

  1. Im Kundenportal unter Instanzdetails → System neu aufsetzen zwischen macOS 14 und 15 wählen.
  2. Die Neuinstallation löscht die gesamte Festplatte unwiderruflich – laden Sie vorher im Kundenportal einen Snapshot herunter.
  3. Komplett selbst durchführbar: Im Schnitt nach 10 Minuten wieder anmeldebereit, neue Zugangsdaten werden automatisch zurückgesetzt und per E-Mail zugestellt.
  4. Unbegrenzt oft und ohne Zusatzkosten. Ob das System nicht mehr startet, Sie eine andere Version möchten oder vor der Kündigung die Platte bereinigen wollen – so geht's.
Glossary

Kleines Glossar

Acht Begriffe, die in Dokumentation und Support-Tickets immer wieder auftauchen – hier einheitlich erklärt, damit alle vom Gleichen sprechen.

Dedicated hardware
Der komplette physische Mac mini wird direkt bereitgestellt. Das Betriebssystem läuft auf echter Hardware, ohne Virtualisierungsschicht – kein Performance-Verlust.
Dediziert
Eine Maschine gehört zu jedem Zeitpunkt nur einem Mieter. CPU, RAM, SSD und die 1-Gbit/s-Bandbreite werden mit niemandem geteilt.
VNC
Protokoll für den grafischen Remote-Zugriff. Nach dem Verbinden sehen Sie den vollständigen macOS-Desktop – für Geräte-Pairing und Systemdialoge unerlässlich.
self-hosted runner
Ein CI-Executor, der auf Ihrer eigenen Maschine registriertist. macOS-Jobs von GitHub Actions bzw. GitLab CI laufen direkt auf diesem Mac, ohne in der offiziellen Warteschlange zu stehen.
Unified Memory
CPU und GPU von Apple Silicon teilen sich einen gemeinsamen Speicherpool. Auf dem 48-GB-Modell lassen sich große quantisierte Modelle direkt laden, ohne durch getrennten Grafikspeicher limitiert zu sein.
Apple Silicon
Von Apple entwickelte ARM-Chips (bei uns M4 / M4 Pro). Natives Zielsystem für iOS-Builds auf echten Geräten sowie MLX- und CoreML-Experimente.
Snapshot
Ein komplettes Abbild der gesamten Festplatte. Lässt sich im Kundenportal jederzeit erstellen und lokal herunterladen – die Absicherung vor Neuinstallation, Kündigung oder Node-Wechsel.
SLA
Zusage zur Verfügbarkeit, bei uns 99,9 %. Bei Nichterreichen erfolgt eine Entschädigung nach festem Schema – Details siehe Sicherheitsversprechen.
Troubleshoot

Checkliste zur Fehlerdiagnose

Diese drei Problemtypen machen rund siebzig Prozent aller Tickets aus. Arbeiten Sie die Punkte in Reihenfolge ab – meist findet sich die Ursache bereits bei Schritt 2 oder 3.

Keine SSH-Verbindung möglich

  1. Im Kundenportal prüfen, ob der Instanzstatus „running“ ist und die Betriebsanzeige normal steht.
  2. Lokal per ping / mtr die Node-Domain testen. Bei hohem Paketverlust erst das Netzwerk wechseln oder mit der Test-IP von Serverstandorte die Route erneut prüfen.
  3. Port 22 und Benutzername dev kontrollieren; mit ssh -v prüfen, an welcher Stelle der Handshake stoppt.
  4. Sich selbst per geänderter sshd_config ausgesperrt? Im Kundenportal die Instanz erzwungen neu starten und die Konfiguration per VNC-Desktop zurücksetzen.
  5. Weiterhin keine Verbindung: Die vollständige Ausgabe von ssh -vvv ins Ticket einfügen.

Fehler bei der Build-Signierung

  1. Bei errSecInternalComponent oder fehlgeschlagenem Schlüsselbund-Zugriff zuerst security unlock-keychain login.keychain-db ausführen.
  2. CI-Sitzungen entsperren den Schlüsselbund standardmäßig nicht – den Entsperrbefehl an den Skriptanfang setzen oder alternativ fastlane match für die Zertifikatsverwaltung nutzen.
  3. Prüfen, ob das Zertifikat importiert ist: security find-identity -v -p codesigning sollte Ihre Signieridentität auflisten.
  4. Meldungen zu „unsupported SDK“ deuten meist auf eine nicht passende Xcode-Version hin – gemäß obiger Anleitung die Version wechseln und erneut versuchen.

Schwarzer Bildschirm bei VNC

  1. Zuerst SSH testen – funktioniert die Anmeldung, läuft das System einwandfrei und es liegt nur ein Problem beim Anzeigedienst vor. Nicht vorschnell neu aufsetzen.
  2. Über SSH den Bildschirmfreigabe-Dienst neu starten: sudo launchctl kickstart -k system/com.apple.screensharing.
  3. Eine zu hohe Auflösung kann einen schwarzen oder verzerrten Bildschirm verursachen – im Client auf 1920×1080 reduzieren und erneut verbinden.
  4. Hilft das nicht, die Instanz im Kundenportal neu starten. Der Host verfügt über einen virtuellen Bildschirm, der nach dem Neustart wieder eine Anzeige liefert.
Tickets

Support-Tickets und Reaktionszeiten

Unser Support-Team deckt im Schichtbetrieb die Zeitzonen UTC+8 und UTC-8 ab. Es gibt genau zwei Kanäle: Ticket im Kundenportal und Support-E-Mail – kein Telefon, kein Live-Chat.

Ticket im Kundenportal (bevorzugt)

So geht's: Im Kundenportal anmelden → Tickets → Neu erstellen und die zugehörige Instanz auswählen. Das Ticket enthält automatisch den Instanz-Kontext und wird dadurch am schnellsten bearbeitet. Geeignet für: Instanzstörungen, Xcode-Versionswünsche, Up-/Downgrades, Unterstützung bei der Neuinstallation.

  • Instanz-ID, Node und Zeitpunkt des Problems angeben
  • Vollständige Befehle und Fehlermeldungen als Text einfügen, keine Screenshots
  • Bereits nach dieser Checkliste geprüfte Schritte aufführen, um Rückfragen zu vermeiden

Support-E-Mail

Bei Anmeldeproblemen im Kundenportal, Fragen zu Rechnungen oder technischen Fragen vor der Bestellung schreiben Sie an support@oncemini.com. Betreff klar formulieren und im Text die registrierte E-Mail-Adresse angeben, um die Zuordnung zu erleichtern.

  • Von der registrierten E-Mail-Adresse aus schreiben, um zusätzliche Identitätsprüfungen zu vermeiden
  • Weitere Kontaktszenarien und Vorlagen finden Sie unter Kontakt
Problemtyp Erste Reaktion Abdeckungszeitraum Empfohlener Kanal
Kritische Störung (Instanz ausgefallen, keine Verbindung möglich) 30 Minuten 7×24 Ticket im Kundenportal, als dringend markieren
Allgemeine technische Fragen (Build, Konfiguration, Performance) 2 Stunden Geschäftszeiten (Schichtbetrieb UTC+8 / UTC-8) Ticket im Kundenportal
Rechnungen, Abrechnung und Fragen vor der Bestellung 1 Werktag Geschäftszeiten support@oncemini.com
Uptime

Betriebsstatus und Benachrichtigungen

FAQ

Häufige Fragen zu Abrechnung und Zahlung

Fragen zu Verbindung und Build finden Sie oben – hier geht es um Kosten und Daten. Preisdetails finden Sie unter Mietpläne.

Ab wann beginnt die Abrechnung?

Die Abrechnung beginnt mit dem Zugang der Zugangsdaten-E-Mail, nicht mit der Bestellung. Bei Tagestarifen wird in 24-Stunden-Schritten gerechnet. Die durchschnittliche Bereitstellungszeit von 5 Minuten wird nicht mitberechnet.

Wie verlängere ich? Wird automatisch abgebucht?

Auf der Instanzdetailseite im Kundenportal können Sie jederzeit manuell verlängern oder die automatische Verlängerung aktivieren. 72 und 24 Stunden vor Ablauf erhalten Sie jeweils eine Erinnerungs-E-Mail. Schlägt die automatische Verlängerung fehl (z. B. abgelaufene Karte), werden Sie sofort per E-Mail informiert und haben eine Karenzzeit von 72 Stunden.

Werden meine Daten sofort gelöscht, wenn ich nicht verlängere?

Nein. Nach Ablauf wird die Instanz zunächst gestoppt, die Daten bleiben 72 Stunden erhalten. Innerhalb dieser Zeit stellt eine Verlängerung alles unverändert wieder her. Nach Ablauf der 72 Stunden werden die APFS-Verschlüsselungsschlüssel vernichtet und die gesamte Festplatte überschrieben – eine Wiederherstellung ist danach nicht mehr möglich. Details siehe Sicherheitsversprechen.

Wie übertrage ich Daten von der alten auf eine neue Maschine?

Solange beide Instanzen noch aktiv gemietet sind, ist die direkte Synchronisation zwischen den Maschinen am schnellsten: rsync -avz -e "ssh -p 22" ~/work/ dev@neuer-node:~/work/. Innerhalb derselben Region über das interne Netz lässt sich die volle Gigabit-Bandbreite ausschöpfen. Alternativ können Sie zunächst im Kundenportal einen Snapshot herunterladen und diesen auf der neuen Maschine wiederherstellen.

Welche Zahlungsmethoden werden unterstützt?

Die Preise auf der gesamten Website sind in US-Dollar angegeben und werden entsprechend abgerechnet. USDT-TRC20 sowie Visa / Mastercard / Amex (Stripe) werden akzeptiert, maßgeblich sind die auf der Zahlungsseite des Portals angezeigten Optionen. Es gibt keine versteckten Traffic-Kosten – der Rechnungsbetrag entspricht genau dem angegebenen Tarifpreis.

Kann ich eine Rechnung erhalten?

Zu jeder Zahlung wird automatisch ein PDF-Beleg erstellt, den Sie jederzeit über die Rechnungsseite im Kundenportal herunterladen können. Für eine bestimmte Firmenbezeichnung oder zusätzliche Steuerangaben schreiben Sie an support@oncemini.com – die Bearbeitung erfolgt innerhalb eines Werktags.

Ich möchte während der Laufzeit die Konfiguration erweitern – wie wird das berechnet?

Ein Upgrade wird anteilig für die verbleibende Laufzeit verrechnet – nur die Differenz wird berechnet, keine doppelte Abrechnung. Reichen Sie die Upgrade-Anfrage im Kundenportal ein, die Daten werden per Snapshot auf die neue Konfiguration übertragen, während die alte Maschine währenddessen weiter nutzbar bleibt. Ein Downgrade ist erst nach Ablauf der aktuellen Laufzeit möglich.

Kann ich bei Unzufriedenheit mit der ersten Bestellung eine Rückerstattung erhalten?

Innerhalb von 24 Stunden nach der ersten Bereitstellung können Sie eine vollständige Rückerstattung beantragen; Verlängerungszeiträume sind davon ausgenommen. Es empfiehlt sich, zunächst für 19,9 $ einen Tagestarif zu testen und dort Ihr eigenes Build-Skript durchlaufen zu lassen, bevor Sie sich für ein Monatsabo entscheiden.

Kostet die Neuinstallation von macOS etwas? Gibt es ein Limit für die Anzahl?

Kostenlos, unbegrenzt oft möglich und komplett selbst im Kundenportal durchführbar – im Schnitt in 10 Minuten abgeschlossen. Wichtig: Die Neuinstallation löscht die gesamte Festplatte, laden Sie vorher einen Snapshot herunter.

Kann ich mit einem Account mehrere Maschinen mieten? Darf ich sie weitervermieten?

Mit einem Account können Sie gleichzeitig mehrere Maschinen mieten – Teams mieten häufig pro Projekt eine eigene Instanz und unterscheiden die Runner per Label. Weitervermietung oder Verkauf an Dritte verstößt gegen unsere Nutzungsbedingungen und führt bei Feststellung zur Kündigung des Dienstes; die gemeinsame Nutzung einer Maschine im eigenen Team ist davon nicht betroffen.

$ oncemini ticket new --priority normal

Ihre Frage war nicht dabei?

Melden Sie sich im Kundenportal an und erstellen Sie ein Ticket – während der Geschäftszeiten erhalten Sie innerhalb von 2 Stunden eine Antwort. Noch keine Maschine? Starten Sie zunächst mit einem Tagestarif.