Help & Troubleshooting

Having trouble with your remote Mac? Start here

Find the right checks for connection, development environment, or order issues. Check access addresses and authorization details in your console order; this page contains no real credentials.

Troubleshooting map Page index · Not a live diagnosis
01Can't access the desktopCheck your order's connection details, then your local network and clientView steps
02Project won't runCheck the system, Xcode, command-line tools, and project dependencies separatelyView steps
03Need help understanding an orderCheck the selected term, add-ons, and USD order totalView steps

This is an informational index. Node details and order status are based on the information returned by the console.

Find the right guide

Search for an issue or browse by topic

Search finds topics on this page; it does not look up your orders or access credentials. For instance-specific issues, check your console.

Before connecting

Check these four things before troubleshooting your client

If the node or connection method in your records doesn't match the order, use the information currently shown in the console. Don't post addresses or credentials in public forums.

  1. 01Order and nodeMake sure you're viewing the order for the right instance. Check the selected dedicated physical node and the connection instructions in the order; don't rely on old records for another machine.
  2. 02Local networkMake sure your local network is working. On a restricted workplace network, check its access policy, then try connecting from a permitted network.
  3. 03Client settingsChoose a remote desktop client supported by the order instructions, then check the connection method, address, and input format. VNC is one way to interact with a desktop, but it's not the only option for every order.
  4. 04Account and permissionsMake sure the account you're using has access to the instance. For team accounts, ask an administrator to check permissions. Don't share login credentials with one another.
Narrow down the issue

Connection issues? Troubleshoot by symptom

Note which step the issue starts at, then change one thing at a time and test again. Network routes, clients, and workload can all affect your experience; we don't publish unverified latency figures.

Before connecting

Can't connect

Check the address and connection method in your order, confirm your local network and client are working, then make sure your account has access to the instance.

If the client shows an error, save the exact message and note when it occurred. Avoid changing several settings at once, or it may be hard to tell what fixed the issue.

Prepare troubleshooting notes
After connecting

Connected, but the display looks wrong

Note whether the screen is black, scaled incorrectly, or not responding to input. Check the client's display settings and make sure your local network isn't switching frequently during the session.

If you can use the desktop, save your work first, then start a new session as described in your order. Don't assume a display issue means the node is faulty.

Screenshot redaction guide
During use

Session disconnected unexpectedly

Note when it disconnected, what you were doing, and any client message. Check whether your local network switched or dropped, then verify the task status after reconnecting.

Don't rely on the desktop view alone to tell whether a build or experiment finished. Check the project logs and artifact directory to avoid running it again unnecessarily.

Check tasks and logs
Development environment

Check the system, toolchain, and project dependencies separately

Check the console for the macOS and software versions available on your physical node. Record the current setup before making changes to meet project requirements. Don't mistake a project dependency issue for a remote connection problem.

System

macOS version

Check the system version on the desktop against your project's and tools' minimum requirements. Record the full version number, not just “latest.”

Development tools

Xcode version

Check the Xcode version in use, project requirements, and required SDK. If multiple versions are installed, confirm which one the build job actually uses.

Command line

Compiler toolchain path

Run xcode-select -p and xcodebuild -version, then compare the paths and versions with what you expect. Before changing the selection, consider the impact on other tasks.

Project

Dependencies and cache

Check the lockfile, package manager version, and project scripts. Verify dependencies with a reproducible minimal task before deciding whether to clear the cache.

Build failed? Find the first useful error

Check these five stages separately: code checkout, dependency installation, compilation, signing, and artifact handling. With a self-hosted runner, also check the run account's permissions, working directory, and how secrets are injected securely.

Keep the failed command, exit status, and redacted logs. Don't include signing materials or raw environment variable values in a support ticket. If the desktop works but the build fails, start with the project logs.

Key terms

Eight terms to help clarify what you mean

Consistent terminology makes it easier to distinguish the machine, location, connection method, and billing choice when describing an issue.

Physical node
The physical machine hosting the Cloud Mac service. The node details in your order identify the location you selected.
Dedicated physical Mac
A physical Mac reserved for your order, not a virtual machine shared with other users.
Cloud Mac
A macOS work environment running on a remote physical node, accessible using the authorized connection method.
VNC
One way to view and interact with a remote graphical desktop. Check your order for available connection methods.
self-hosted runner
A runner configured and managed by your team to execute automated build jobs.
Billing term
The billing period selected at checkout: day, week, month, or quarter. Your confirmed order is the source of truth.
Node
The location selected when placing your order. It does not guarantee a particular network speed or determine the client connection address.
Additional storage
Storage selected in addition to the base configuration. See the plan page for specifications and pricing by term.
Orders & payments

How do I check the amount, term, and payment method?

Start with the term and add-ons selected in your order, then check the final amount shown in USD. The plan page lists full-term prices and add-ons; don't estimate an order using the price for a different term.

What currency are orders billed in?

All orders are billed in US dollars (USD). Check the model, term, add-ons, and final amount together in the same order. Prices are listed separately by term and aren't calculated by simply multiplying a daily rate.

Which payment methods are accepted?

We accept USDT-TRC20 and Visa / Mastercard / Amex processed through Stripe. The payment options available at checkout depend on what the backend returns. If a payment doesn't complete, check the order status before trying again.

Where can I check my term and add-ons?

First, visit the Plans & Pricing page to view the available options, then check the selected term, node, and add-ons in your console order. The order confirmation is the source of truth for what you purchased.

Before submitting a ticket

Share reproducible details, never secrets

For issues with an existing order, submit a support ticket from the console. Include the checks you've already completed so support can continue with the steps that haven't been ruled out.

  1. 01Order and locationInclude the order ID, selected node, and affected instance. There's no need to copy access credentials.
  2. 02Time and symptomsInclude the time and time zone, client environment, exact error message, and whether the issue happens every time.
  3. 03Steps and checksList the steps to reproduce the issue in order, along with any network, permissions, client, or project log checks you've completed. “Can't connect” alone isn't enough.
  4. 04Redacted attachmentsInclude only the parts of screenshots or logs needed to investigate. Hide passwords, keys, tokens, signing materials, and unrelated personal information.

Never send passwords or keys.If more information is needed, continue the conversation only through a console support ticket. For general pre-sales questions, you can also email support@vpspush.com.

Next steps

Still need help? Contact us with your troubleshooting notes

For an existing order, sign in to the console and submit a support ticket with the checks you've completed. For pre-sales questions, visit the contact page to find the right way to reach us.