Erst Fakten sichern,
dann Cloud-Mac-Probleme lösen.
Praxisleitfäden für Erstverbindungen, VNC-Sitzungen, Xcode-Builds und Bestellfragen. Prüfe lokales Netzwerk, Knotenstatus, Zugangsdaten, Client und Task-Protokolle Schritt für Schritt statt ungezielt erneut zu verbinden.
- Verfügbare Knoten
- 6 Regionen
- Verfügbare Konfigurationen
- 2 Modelle
- Wichtig bereithalten
- Region, Zeit, Fehlertext
Wähle die passendste Problemkategorie
Alle sechs Einstiege sind sichtbar. Die Auswahl führt nur zu den passenden Prüfpunkten und blendet keine anderen Leitfäden aus.
Desktop-Sitzung kann nicht hergestellt werden
Beginne mit lokalem Netzwerk, Zieladresse, Client-Version und belegten Sitzungen.
Verbindung prüfen ZugangsdatenVerbindungsdaten funktionieren nicht
Prüfe, ob Adresse, Benutzername und Zugangsdaten zur selben Bestellung gehören, und entferne überflüssige Leerzeichen.
Erstnutzung prüfen LeistungBild, Eingabe oder Tasks werden langsamer
Dokumentiere Netzwerklatenz, Desktop-Qualität und Task-Ressourcen getrennt, statt alles zu einem Befund zusammenzufassen.
Prüfreihenfolge ansehen BestellungBestellung oder Abrechnung prüfen
Halte Bestellnummer, Abrechnungszeitraum, USD-Betrag und Zahlungsergebnis bereit und reiche dann ein Konsolen-Ticket ein.
Support-Ablauf ansehen SpeicherZusätzlicher Speicher funktioniert nicht wie erwartet
Notiere Zusatzoption, erkannte Systemressource, Mount-Pfad und Zeitpunkt des ersten Auftretens.
Anfragedaten vorbereiten BuildXcode- oder Runner-Task fehlgeschlagen
Sichere Version, Label, Arbeitsverzeichnis, vollständiges Protokoll und minimale Reproduktionsschritte.
Build-Fehler prüfenVom verfügbaren Knoten bis zum geprüften Desktop
Jeder Schritt hat ein klares Prüfergebnis. Wenn ein Schritt fehlschlägt, sichere zuerst die Situation und ändere nicht mehrere Variablen gleichzeitig.
Knotenstatus prüfen
Melde dich in der Konsole an, öffne die passende Bestellung, bestätige den verbindungsbereiten Knoten und prüfe, ob Region und Kaufangabe übereinstimmen.
- Bestellnummer korrekt
- Modell und Region stimmen überein
- Knoten verfügbar
Verbindungsdaten abrufen
Kopiere Serveradresse, Benutzernamen und Zugangsdaten getrennt. Führe Felder nicht zusammen und teile sie nicht in öffentlichen Dokumenten oder Chats.
- Adresse ohne überflüssige Leerzeichen
- Benutzername separat erfasst
- Zugangsdaten gehören zur aktuellen Bestellung
VNC-Sitzung herstellen
Gib Zieladresse und Benutzernamen in einem vertrauenswürdigen VNC-Client ein. Stelle die Sitzung zunächst mit Standardqualität her und passe Auflösung und Farbtiefe anschließend an das Netzwerk an.
- Unterstützte Client-Version
- Lokales Netzwerk erlaubt die Verbindung
- Fehlertext vollständig gesichert
Desktop-Erstprüfung abschließen
Prüfe nach dem Öffnen der macOS-Oberfläche Tastatureingabe, Anzeigeskalierung, Terminal und Projektverzeichnis, bevor du Repository oder Runner startest.
- Eingabe und Anzeige funktionieren
- Terminalbefehle ausführbar
- Projektverzeichnis les- und beschreibbar
Immer nur eine Verbindungsebene prüfen
Bestimme zuerst, ob das Problem lokal, bei den Zieldaten, Zugangsdaten, im Client oder in einer bestehenden Sitzung liegt. Dokumentierte Einzelergebnisse sind hilfreicher als ständiges Neuverbinden.
| Schritt | Prüfobjekt | Konkrete Aktion | Zu dokumentieren | Erfolgskriterium |
|---|---|---|---|---|
| 01 | Lokales Netzwerk | Wechsle zu einem bekannten stabilen Netzwerk und prüfe, ob Firewall oder Proxy die VNC-Verbindung blockieren. | Netzwerktyp, Proxy-Nutzung, Fehlerzeit | Zieladresse im selben Netzwerk erreichbar |
| 02 | Zieladresse | Kopiere die Serveradresse erneut aus der aktuellen Bestellung, nicht aus alten Screenshots oder einer anderen Bestellung. | Bestellnummer, Knotenregion, Quelle des Adressfelds | Adresse stimmt mit dem aktuellen Knoten überein |
| 03 | Verbindungsdaten | Prüfe Benutzername und Zugangsdaten getrennt auf Leerzeichen oder Zeilenumbrüche vor und nach dem Kopieren. | Fehlertext, kein echtes Passwort | Client meldet keinen Authentifizierungsfehler mehr |
| 04 | Client-Version | Notiere Clientname, Version und Anzeigeeinstellungen; prüfe bei Bedarf mit einem zweiten vertrauenswürdigen Client. | Client-Version, Betriebssystemversion, Qualitätseinstellungen | Stabile Sitzung mit denselben Daten |
| 05 | Sitzungsstatus | Prüfe belegte Sitzungen, eingefrorene Anzeige und ungültige Verbindungen, die der Client noch hält. | Aktion vor Abbruch, Wiederverbindung, Sitzungszeit | Nach Schließen alter Sitzungen erneut verbindbar |
Eingabelatenz, langsame Bildaktualisierung und Build-Dauer sind drei verschiedene Messwerte. Dokumentiere Netzwerkbedingungen, VNC-Qualität und Task-Protokoll getrennt, statt alles der Knotenleistung zuzuschreiben.
Projektkonfiguration und Knoten-Umgebung unterscheiden
Sichere zuerst den fehlgeschlagenen Ablauf und erstelle dann eine minimale Reproduktion. Alle sechs Punkte müssen aus demselben fehlgeschlagenen Task stammen.
Xcode- und Tool-Versionen
Notiere die vollständige Xcode-Version, die Auswahl der Kommandozeilenwerkzeuge und den tatsächlich verwendeten Build-Befehl.
Worauf achten Ob dasselbe Projekt mit fester Version wiederholt fehlschlägt.Vollständiges Projektprotokoll
Bewahre den Kontext vor und nach dem fehlgeschlagenen Schritt auf, statt nur die letzte Fehlermeldung zu kopieren.
Worauf achten Ob der Fehler aus Abhängigkeiten, Kompilierung, Tests, Export oder Skriptphase stammt.Zeitpunkt des Fehlschlags
Notiere Zeitzone, Startzeit, Fehlerzeit und Task-Dauer, damit sie dem Knotenprotokoll zugeordnet werden können.
Worauf achten Ob das Problem bei einem festen Schritt oder nach einer festen Laufzeit auftritt.Runner-Label und Verzeichnis
Bestätige, dass der Workflow das erwartete Label trifft, und notiere Arbeits-, Cache-Verzeichnis und Ausführungskonto.
Worauf achten Ob der Task an den richtigen self-hosted Runner geleitet wurde.Minimale Reproduktionsschritte
Entferne irrelevante Skripte und parallele Tasks und reproduziere denselben Fehler mit möglichst wenigen Befehlen.
Worauf achten Ob der Fehler von Projektkonfiguration, Cache oder Umgebungsvariablen abhängt.Vergleichsergebnis
Teste auf demselben Knoten in einem sauberen Arbeitsverzeichnis erneut oder führe ein Minimalbeispiel mit derselben Toolchain aus.
Worauf achten Wenn auch das Minimalbeispiel fehlschlägt, reiche ein Ticket zur Knoten-Umgebung ein.Nur bestimmte Branches, Abhängigkeiten, Caches oder Skripte schlagen fehl; ein sauberes Beispiel läuft.
Mehrere unabhängige Projekte scheitern beim selben Toolschritt, und das Minimalbeispiel lässt sich stabil reproduzieren.
Im Ticket einheitliche Begriffe verwenden
Klare Begriffe vermeiden Rückfragen durch wechselnde Bezeichnungen wie Maschine, Instanz und Server.
- Physischer Knoten
- Physischer Mac mini für macOS und Entwicklungsaufgaben. Status, Region und Verbindungsdaten sind mit der jeweiligen Bestellung verknüpft.
- Dedizierter physischer Rechner
- Eine Bestellung entspricht einer unabhängig genutzten physischen Ressource; dieselbe Betriebssystemumgebung wird nicht mit anderen Kunden geteilt.
- Keine virtuelle Maschine
- Bereitgestellt wird eine macOS-Umgebung auf echter Hardware, keine aus einem gemeinsam genutzten Host abgetrennte virtuelle Instanz.
- VNC
- Verbindung zum Anzeigen und Bedienen eines entfernten grafischen Desktops. Qualität, Skalierung und Eingabelatenz hängen von Netzwerk und Client-Einstellungen ab.
- Self-hosted Runner
- Automatischer Task-Runner auf dem gemieteten Cloud-Mac, den das Team selbst registriert und verwaltet.
- Abrechnungszeitraum
- Für die Bestellung gewählter Tages-, Wochen-, Monats- oder Quartalszeitraum. Bei der Abrechnung Modell, Zeitraum und Zusatzoptionen gemeinsam angeben.
- Knotenregion
- Service-Region des Geräts. BAMini bietet Knoten in Singapur, Tokio, Seoul, Hongkong, US-Ostküste und US-Westküste – insgesamt 6 Regionen.
- Thunderbolt-5-Parallelschaltung
- Zusätzliche Verbindungsfunktion, die pro Gerät gewählt wird. Bei Anfragen Geräteanzahl und Verbindungstopologie angeben.
Damit der Support reproduzieren und prüfen kann
Eine bearbeitbare Anfrage braucht Bestellkontext, Zeitpunkt, vollständigen Fehler und bereits getestete Schritte. Vertrauliche Zugangsdaten gehören nicht in die Diagnoseunterlagen.
Checkliste zum Problem
Dient zur Zuordnung der Bestellung; nicht nur den Modellnamen angeben.
Singapur, Tokio, Seoul, Hongkong, US-Ostküste oder US-Westküste angeben.
BookAMini M4 Core oder BookAMini M4 Plus angeben.
Datum, Uhrzeit und Zeitzone angeben, damit der Eintrag dem Knotenprotokoll zugeordnet werden kann.
Originaltext kopieren und Fehlercode sowie Kontext erhalten, statt nur „funktioniert nicht“ zu schreiben.
In Ausführungsreihenfolge auflisten und das Ergebnis jedes Schritts nennen.
Angeben, ob der Fehler immer, gelegentlich oder nur bei bestimmten Projekten und Netzwerken auftritt.
Wenn die Selbstprüfung nicht reicht: Konsolen-Ticket einreichen
Probleme bestehender Bestellungen gehören bevorzugt in ein Konsolen-Ticket, damit Bestellung, Knoten und Ergänzungen verknüpft werden können. Wenn du dich nicht anmelden kannst, nutze die Support-E-Mail.
Problem und Kontext einreichen
Erstelle in der Konsole ein Ticket, wähle die passende Bestellung und füge Region, Modell, Zeit, Fehlertext, Protokollauszüge und Reproduktionsschritte hinzu.
Verbindung, Umgebung oder Abrechnung unterscheiden
Der Support grenzt den Bereich anhand der Nachweise ein. Bei fehlenden Angaben nennt das Ticket die konkret benötigten Felder.
Im bestehenden Ticket antworten
Gib bei neuen Protokollen Zeitpunkt und Testbedingungen an und erstelle für dasselbe Problem kein weiteres Ticket.
Ergebnis und nächste Schritte ansehen
Prüfe in der Konsole Bearbeitungsstand, empfohlene Maßnahmen und zu bestätigende Ergebnisse. Bestätige nach der Prüfung im ursprünglichen Eintrag, ob das Problem behoben ist.
Bestehende Bestellung oder Knoten
Reiche ein Konsolen-Ticket ein und verknüpfe die passende Bestellung.
Konsole öffnenAnmeldung an der Konsole nicht möglich
Schreibe von der E-Mail-Adresse deines Kontos und nenne Bestellnummer sowie das Anmeldeproblem.
support@bookamini.comWähle aus 6 Knoten und zwei Modellen mit dedizierter physischer Hardware.
BookAMini M4 Core und BookAMini M4 Plus sind Cloud-Macs mit dedizierter physischer Hardware und keine virtuellen Maschinen. Bestellungen werden in USD abgerechnet; die Verfügbarkeit in der Konsole ist maßgeblich.