From connection to automated operations

Connect your Cloud Mac, keep it reliable, and plug it into your workflow

This is more than a glossary. Every guide provides a check sequence, verification criteria, and the information needed when escalating to support—covering graphical desktops, command-line work, and automation on dedicated Apple Silicon physical nodes.

6 categories Searchable topics
3 paths Primary workflows
5 types Troubleshooting decision trees
Issue search

Choose an entry by task, then narrow it down with keywords

Enter terms such as “black screen,” “runner,” “disk,” or “payment,” or choose a category. Search only filters the entry cards below; it does not hide the full guides that follow.

First connection

From connection details to desktop verification

Check the node, establish a secure connection, verify the keyboard and display, then update the initial credentials during the first session.

View the full sequence
Remote desktop

Display, bandwidth, and session recovery

Start with client setup, then tune resolution, color, and image quality while handling unstable networks and reconnecting after interruptions.

Open the desktop guide
Command line

Verify SSH and least privilege

Confirm the host fingerprint, connection port, and account permissions, then connect Git, scripts, or operations tasks to the node.

View connection steps
CI/CD

Deploy a self-hosted runner

Isolate workspaces, control signing materials and cache boundaries, and schedule concurrent builds around actual resources.

Open the configuration checklist
Storage

Find disk usage and clean up safely

Check workspaces, build artifacts, and caches first. Then decide whether to clean up, export data, or add an SSD to the next order.

View disk troubleshooting
Billing

Review billing cycles, add-ons, and payment records

Use the order ID as your reference to verify the model, node, billing cycle, SSD, and Thunderbolt 5 add-ons.

View pricing details
First connection

Complete your first session in five checkpoints

Do not install tools as soon as you receive the connection details. Verify the node, network, display, and credentials first so later build issues can be separated from connection issues.

  1. 01

    Get connection details from the console

    Record the order ID, node region, host address, port, initial username, and connection method. Store connection details only in a controlled location; never forward them to public chats or code repositories.

    Done when: the order ID and host address identify the same instance.
  2. 02

    Confirm the node and source network

    Verify that the selected node is in Singapore, Tokyo, Seoul, Hong Kong, or the U.S. West, and record your current network egress. Team members should record their source networks separately during testing so local path differences are not mistaken for a node issue.

    Done when: the node, source network, and test time are all recorded.
  3. 03

    Establish a secure connection and verify the host

    Use the method specified in the connection details to access the graphical desktop or command line. On the first SSH connection, verify the host fingerprint. For graphical desktop access, confirm the destination address and port, and reject connection settings from unknown sources.

    Done when: you can open a session and the target host details match the order.
  4. 04

    Verify the keyboard, display, and time zone

    Test Chinese and English input, common modifier keys, copy and paste, display scaling, and the time zone. If keys behave incorrectly, first align the local client and remote macOS keyboard layouts, then adjust shortcut mappings.

    Done when: common shortcuts work and text input and display scaling meet your needs.
  5. 05

    Update initial credentials and save recovery details

    After the first successful connection, update the initial credentials with a unique, sufficiently long password and limit sharing. Keep automation and everyday desktop accounts separate so the runner, manual work, and troubleshooting do not share the same permission boundary.

    Done when: the old credentials no longer work and the new credentials are in controlled team storage.
Remote Mac desktop

Stabilize the session before increasing image quality

Remote desktop experience depends on the local network, round-trip latency, resolution, color depth, and screen activity. Change only one variable at a time while troubleshooting.

Prepare

Client and address

Use a VNC client that supports encrypted connections and session recovery. After importing the connection details, verify the address, port, and username first; do not save uncontrolled plaintext passwords.

  • Update to the current stable client version
  • Disable proxy rules that rewrite the destination address
  • Keep a connection-parameter record without sensitive credentials
Display

Resolution and color

Start the first connection with one display and a medium resolution. Increase image size or color quality only after confirming smooth interaction. Do not enable high resolution, multiple displays, and maximum quality at the same time.

  • If text is too small, adjust system scaling first
  • For color-sensitive work, fix the client color settings
  • If the image tears, lower refresh rate and quality first
Unstable network

Reduce screen activity

On an unstable network, lower resolution, color depth, and motion effects first. Terminals, editors, and static interfaces use less bandwidth; enable video previews and large animations last.

  • Disable dynamic desktop backgrounds and transparency effects
  • Avoid playing high-bitrate video in the session
  • If instability continues, retest from another network
Recovery

Recover the session after an interruption

After a network interruption, reconnect to the original session first rather than creating multiple desktop sessions in succession. Once reconnected, check that build processes, file transfers, and unsaved work are still in the expected state.

  • Wait briefly for a transient network fluctuation to end
  • Before reconnecting, confirm that the address has not been rewritten
  • After recovery, check processes and logs for long-running tasks
Three workflows

Choose the entry point by task—desktop access is not required for everything

Use the graphical interface for Xcode, design checks, and interactive debugging; the command line for Git, logs, and operations; and isolated accounts and runners for automation.

Graphical desktop

Xcode, simulators, media checks, and tasks requiring visual feedback.

SSH command line

Pull repositories, inspect logs, transfer files, and run repeatable scripts.

Automation

A self-hosted runner receives queued jobs, runs isolated builds, and reports status.

CI/CD runbook

Make your runner cleanable, traceable, and concurrency-controlled

A dedicated physical machine does not define your build boundaries for you. Your team still needs to configure the runner account, workspace, signing materials, cache policy, and concurrency.

RUNNER MANIFEST Build node runbook
Dedicated node
01

Create a dedicated runner account

Do not use an everyday desktop account for continuous integration. Grant only the permissions required to complete builds, and document how the service starts and stops.

02

Isolate directories by repository or pipeline

Use clearly defined directories for source code, dependency caches, archives, and temporary output. After a failed job ends, you should still be able to tell what can be deleted.

03

Keep signing materials out of scripts and logs

Store certificates, private keys, repository tokens, and CI secrets in controlled storage, and inject them at runtime. Build logs must never print complete secrets.

04

Set cache lifecycles

Separate reusable dependency caches, regenerable DerivedData, and artifacts that must be retained. Define a cleanup trigger for each type of content.

05

Validate with one concurrent job first

Use a single job to verify the environment, signing, and output paths before increasing concurrency. After increasing concurrency, monitor memory, disk space, and build duration.

Pre-launch verification

Minimal successful pipeline

  • Check out a fixed commit
  • Install locked dependency versions
  • Run a deterministic test suite
  • Generate identifiable build artifacts
  • Clean the temporary workspace
Compare two models
Concurrency guidance

Review resource curves instead of relying on vague speed claims

Large projects, parallel CI, AI experiments, and high-load audio/video processing are better suited to HireVM Pro, configured with M4 Pro, 64GB RAM, and 2TB SSD. For everyday development, remote desktop use, and lightweight builds, start by evaluating HireVM M4, configured with M4, 16GB RAM, and 256GB SSD.

View full pricing
Glossary

Eight terms that directly affect configuration and troubleshooting

These are not marketing labels. They describe resource ownership, connection protocols, automation roles, network conditions, and order time boundaries.

Physical node
An Apple Silicon device that actually runs macOS workloads. The node region determines the primary network path used for remote access.
Dedicated
Each order maps to separate compute resources. The machine’s processor, memory, and local storage are not shared with other tenants.
Non-virtualized
The delivered resource is a dedicated physical machine, not a virtual compute instance divided from the same host.
VNC
A protocol for viewing and controlling a graphical desktop remotely. Experience depends on round-trip latency, screen size, color, and network fluctuations.
SSH
A protocol for secure command-line access, suitable for Git, scripts, logs, file transfers, and automated operations.
self-hosted runner
A pipeline execution agent deployed by the team on an owned or rented node. It receives jobs, builds, tests, and reports results.
Node latency
The round-trip time for data to travel from the source network to the node and back. It varies with the carrier, route, time of day, and local network.
Billing cycle
The usage period calculated by day, week, month, or quarter. The model, node, and add-ons together determine the final USD amount.
Troubleshooting decision tree

Start with the shortest check chain; do not change multiple variables at once

First confirm that the symptom is reproducible, then follow the matching branch. Include the branch ID and results in your ticket so support can continue directly from the failure point.

NET-01 Unable to connect or connection timed out
  1. Check the target: Confirm that the address, port, username, and node match the console record.
  2. Rule out the local network: Disable proxy rules that rewrite the destination, then retest from another source network.
  3. Separate the protocols: Record whether the graphical desktop and SSH are reachable separately to determine whether one entry point or the entire path is affected.
  4. Include when escalating: Order ID, node, time of occurrence, source network, client name, original error text, and the results of the three steps above.
NET-02 Latency suddenly increases or the display stutters
  1. Establish a comparison: Record the current source network, node, and round-trip latency. Do not directly combine these results with tests from other regions.
  2. Reduce display load: Lower resolution and color quality, and disable animations and video previews.
  3. Change the source: Test over another network to determine whether the fluctuation is limited to the local path.
  4. Include when escalating: Node, results from both source networks, time period, client parameters, and issue duration.
DSK-01 Insufficient disk space
  1. Locate directories: Check source code, DerivedData, dependency caches, archives, simulator data, and logs separately.
  2. Separate data: Export artifacts that must be retained first, then delete regenerable caches and failed-job directories.
  3. Review automation: Confirm that the runner performs cleanup after both successful and failed jobs.
  4. Include when escalating: Model, remaining capacity, largest directories, items cleaned, and expected future capacity needs.
BLD-01 Build fails or runner does not accept jobs
  1. Narrow the scope: Pin the commit, dependency lockfile, Xcode version, and build command, then reproduce with a single job.
  2. Check the runner: Confirm the service process, workspace permissions, queue labels, and environment variables.
  3. Check the materials: Verify that signing materials are readable, but never write private keys or complete tokens to logs.
  4. Include when escalating: Model, failed step, command, redacted original error, last successful build, and checks already performed.
IAM-01 Invalid credentials or unexpected permissions
  1. Confirm the account: Distinguish the desktop account, automation account, and repository access credentials to avoid using the wrong identity.
  2. Confirm changes: Record whether the credentials were recently updated, revoked, or had their permissions changed.
  3. Stop repeated attempts: When failures continue, pause automation jobs to avoid generating large numbers of invalid requests and confusing logs.
  4. Include when escalating: Order ID, account purpose, error time, original error, and permission scope. Do not submit passwords, private keys, or complete tokens.
Technical content

Continuously organized around real remote development tasks

The Help Center covers six fixed technical topics. Once the full articles are published, read them by title in the technical blog; this page does not show fictional dates or unpublished article links.

CI/CD Environment control and ongoing costs

Xcode Cloud vs. a HireVM self-hosted Cloud Mac: a complete comparison of control and ongoing costs

Compare build-environment control, dependency caching, signing materials, concurrency strategy, debugging paths, and ongoing costs to decide when to use a managed pipeline or deploy a self-hosted runner.

Cost planning

Which development teams benefit most from renting a HireVM Cloud Mac by the day?

Use working hours, configuration needs, and data migration costs to determine the right boundary for short-term rental.

iOS development

Test iOS version upgrades on a dedicated Cloud Mac

Cover the test branch, Xcode environment, compatibility records, and archived builds.

Remote development

How to set up a HireVM remote Mac development environment

Configure accounts, SSH, Git, Xcode, package managers, and development credentials in sequence, then add checks for unstable-network optimization and data export.

Release process

Pre-submission checklist for avoiding App Store review issues from a Cloud Mac

Verify signing and provisioning profiles, privacy disclosures, permission purposes, test accounts, metadata consistency, and archive results.

Development tools

Docker and OrbStack on Apple Silicon Cloud Macs

Compare installation, resource usage, file sharing, and network configuration, then document isolation and cleanup practices for dedicated physical nodes.

Support escalation path

Start every ticket with reproducible facts

Complete the shortest check chain in the relevant guide before submitting enough context. Do not upload passwords, private keys, complete access tokens, signing private keys, or unrelated code.

1

Confirm the guide branch

State whether you reviewed First connection, Remote desktop, CI/CD, Storage, or Billing, and identify the step where you stopped.

2

Fix the issue context

Provide the order ID, HireVM M4 or HireVM Pro, node, time of occurrence, and source network.

3

Include the original error

Copy the complete error text or a redacted log excerpt. Do not write only “cannot use,” “slow,” or “build failed.”

4

List the steps already performed

Write the results of retesting the network, adjusting the client, cleaning directories, or rerunning commands in order, so support does not need to repeat the questions.

Next step

Need a dedicated Cloud Mac ready to enter your workflow now?

Choose HireVM M4 or HireVM Pro, then select a region from Singapore, Tokyo, Seoul, Hong Kong, or the U.S. West. Actual availability is determined by the console in real time.