Connectivity & Build Support

Find the issue first, then submit a reproducible node record

This guide covers first-time Cloud Mac access, remote desktop, SSH, macOS, Xcode, CI Runner, storage expansion, and order processing. Follow the registration board in order to avoid changing the network, credentials, and build environment at the same time.

SUPPORT ROUTE Issue routing
Check in order
01
Connection details Verify the host details, username, and access method
Input
02
Node status Use the node record returned by the portal
Confirm
03
Local-to-node network Check resolution, port access, and link stability separately
Measure
04
Toolchain & task Pin versions and reproduce with a minimal task
Reproduce
Minimum ticket details Order ID + region + time + redacted logs
4 FIELDS
Connection diagnostics

Five steps to narrow down connection issues

Do not start by reinstalling the client or resetting the environment. Confirm the registration details first, then determine whether the issue is with the credentials, node, local network, client, or specific session.

  1. 01

    Confirm the credentials match the current node

    Reread the order ID, node region, host details, username, and credential-generation status from the portal. Do not continue using old tickets, screenshots, or historical connection details forwarded by team members.

    Confirm the inputs first
  2. 02

    Check the node's online status

    Check whether the node record in the portal has entered an accessible state. While delivery registration is still in progress, keep the current record; do not recreate the connection configuration or rotate credentials repeatedly.

    Confirm the node next
  3. 03

    Separate network connectivity issues

    Test host resolution and the target port on both your current network and another trusted network. Record the test time, network type, and result; do not use a single latency figure as a complete diagnosis.

    Measure the path
  4. 04

    Verify the client settings

    Confirm that the connection protocol, host field, port, username, and selected credentials are correctly aligned. For remote desktop issues, also distinguish session establishment, display updates, keyboard mapping, and local display settings.

    Pin the client
  5. 05

    Collect the minimum reproduction logs

    Keep the original error text, occurrence time, reproduction steps, and client version. For SSH, provide redacted verbose connection output; for remote desktop, record the complete sequence from starting the connection to the appearance of the error.

    Build the evidence
System & toolchain

Pin versions first, then isolate project differences

System upgrades, Xcode changes, and dependency updates can alter several variables at once. Before troubleshooting, record the current environment and validate the basic toolchain with a minimal project.

ENV-01

Check macOS and Xcode versions

Record the macOS version, full Xcode version, current command-line tools path, and project requirements. The toolchain reported by the graphical interface and command line should match.

  • Confirm the project's minimum and target system versions
  • Confirm that the selected Xcode and command-line tools match
  • Build and test with a minimal project first
ENV-02

Confirm compatibility before installing

Before updating the system, Xcode, package manager, or build dependencies, verify project compatibility, free disk space, and rollback materials. Do not switch versions midway through a critical running task.

  • Save the current versions and dependency lockfiles
  • Confirm the required space and download source for the new version
  • Create a separate working directory for validation tasks
ENV-03

Plan cache directories

Keep source code, dependency caches, build intermediates, test results, and final artifacts separate. This makes it easier to determine whether disk growth comes from project content, cache-hit changes, or build artifacts.

  • Set explicit cache paths and cleanup conditions
  • Do not keep final artifacts only in a temporary directory
  • Record directory sizes and task impact before cleanup
ENV-04

Isolate project environments

Use separate directories, locked dependencies, and environment-variable sets for different repositories, branches, and experimental tasks. When an issue occurs, reproduce it with the same commit and dependency versions.

  • Organize working directories by repository or task
  • Record the source of environment variables without committing sensitive values
  • Use an initialization script that can be run repeatedly
CI/CD troubleshooting

When a Runner is offline, check the control plane before the build script

Check job pickup, signing environments, caches, concurrency, and disk separately. Changing Runner configuration, dependencies, and cache policies in one task makes the result difficult to reproduce.

RUNNER

Runner cannot pick up jobs

Check the process status, task labels, project authorization, queue assignment, and most recent heartbeat. Confirm which repository or organization the Runner is actually registered to.

Output: online record and queue screenshot
SIGNING

Signing step failed

Verify that the signing materials are complete, permissions are correct, and the script uses the expected path. Provide only redacted errors and material types in the ticket; never submit sensitive credentials.

Output: failed step and original error text
CACHE

Cache miss or slower builds

Compare the cache key, dependency lockfiles, hit records, and working directory. First run one minimal task with caching disabled to confirm whether the issue actually comes from the cache layer.

Output: cache key and hit changes
QUEUE

Concurrent tasks are blocking one another

Check the number of simultaneous tasks, shared directories, ports, simulator resources, and artifact paths. Assign separate workspaces to parallel tasks to prevent them from overwriting one another.

Output: queue order and concurrency count
DISK

Disk usage keeps increasing

Measure source, dependencies, caches, intermediate files, logs, and artifact directories separately. Before cleanup, confirm that no task is still using the relevant directory and save any required artifacts.

Output: directory usage comparison
Storage & expansion

Assess capacity by actual working set and Thunderbolt 5 daisy chaining

Include source code, dependency caches, build intermediates, test data, assets, models, and final artifacts in the estimate. Expansion options address specific capacity or daisy-chaining needs; they do not replace project backups.

STORAGE CHECK

Four details to confirm before making changes

  • Are the current model, node region, and order ID correct?
  • Current free space, estimated new data volume, and cache growth rate
  • Whether expansion is for long-term data, a temporary working set, or batch assets
  • Number of Thunderbolt 5 daisy-chained devices, connection method, and task dependencies

To change an existing order, open the portal and submit a ticket linked to the order record. Do not change storage paths or disconnect a device in use while a task is running.

TB5

Tasks suited to daisy chaining

Large asset batch processing, workflows that clearly depend on high-speed external storage, and long-running tasks that need a dedicated work disk. First confirm that the software, file system, and task paths can use the daisy-chained devices correctly.

Priced per daisy-chained device
BACKUP

A local node copy is not the only copy

Keep separate copies of project repositories, signing materials, models, assets, and build artifacts according to your team's policy. Expansion solves workspace capacity needs; it does not replace version control or backup procedures.

Confirm where the data will go before making changes
Storage & Thunderbolt 5 Add-on Pricing
Add-on Daily Weekly Monthly Quarterly
+1TB SSD $2.6 $7 $12.9 $35.1
+2TB SSD $5.2 $14 $25.8 $70.2
Thunderbolt 5 daisy chaining, per device $1.9 $5.2 $9.7 $26.4
Support request template

Submit enough information to locate the issue in one request

A clear request tells support which order and region are involved, when the issue occurred, how to reproduce it, and what you expected to see. “I can't connect” or “the build failed” alone is usually not enough to begin troubleshooting.

REQUEST RECORD

Node issue report

Copy and fill in
Order ID
Enter the order ID associated with the affected node in the portal.
Node region
Singapore, Japan (Tokyo), South Korea (Seoul), or Hong Kong.
Time of occurrence
Include the local time, time zone, and whether the issue is ongoing.
Reproduction steps
Start from the normal state and list each step in the order it was performed.
Redacted logs
Keep the original error text, removing passwords, keys, tokens, and project secrets.
Expected result
Describe the state, output, or task result that should have appeared.
GOOD SIGNAL

Also include

Client version, macOS and Xcode versions, Runner labels, failed task ID, network type, and the last successful operation before the issue occurred.

All details should correspond to the same reproduction
REMOVE FIRST

Remove before submitting

Passwords, private keys, access tokens, original signing materials, payment credentials, complete environment-variable files, and unprocessed project source code.

Submit only the minimum evidence needed to locate the issue
Account & orders

Handle payments, billing, and node records through the portal

The order total consists of the selected model, rental period, node region, and add-ons. Submit issues with existing orders through the portal so the ticket can be linked automatically to the account and node record.

Which payment methods and settlement currency are supported?

Only USDT-TRC20 and Visa / Mastercard / Amex (via Stripe) are supported. All orders are settled in US dollars (USD); available gateways are determined by the portal.

What makes up the order total?

The total consists of the base model, the daily, weekly, monthly, or quarterly rental period, the node region, and selected storage or Thunderbolt 5 daisy-chaining add-ons. Review each billing line before submitting.

Why submit connection or configuration issues through the portal?

A portal ticket can be linked to the order ID, node region, and delivery record, reducing back-and-forth checks. Include the occurrence time, reproduction steps, redacted logs, and expected result when submitting.

How should access credentials be handled when team members change?

Review team permissions promptly, update the relevant credentials, and revoke access that is no longer needed. Never send unredacted credentials in email, chat messages, or tickets.

Escalation options

Put the node record and reproduction evidence in the same ticket

Submit order, connection, billing, or build issues through the portal first. For configuration reviews, bulk nodes, and business collaboration needs, contact the service team for further confirmation.