From order to desktop

How do you connect to your cloud Mac desktop?

Find the authorized access details in your order in the console, connect with a compatible client, then verify the machine and session on the desktop. You’re connecting to a dedicated physical Mac, not a virtual machine.

The address, credentials, and available connection methods are shown in your order. This page doesn’t display real connection details.

Connection overview

Remote desktop handles interaction; your order provides authorization

VPSPush M4 is a dedicated physical Mac mini M4 that gives you a remotely accessible cloud Mac desktop. Use remote desktop to open graphical apps, check build results, and handle tasks that need manual input. Background build tasks still require you to configure the necessary tools and permissions.

Machine locationRefer to the physical node selected in your order. Don’t infer its location from the connection address.
Connection detailsUse only the authorized details in the console. Don’t copy an address from a public illustration.
Connection methodChoose a client based on the method listed in your order. Don’t assume every order uses the same protocol.
Before you connect

Check these items before connecting

Checking your order, permissions, and local setup first makes it easier to pinpoint issues than repeatedly trying to connect. View this information only in your own console and client. Don’t share it in public discussions.

01

Order and node

Make sure you’re viewing the right order, and check the selected region and machine details. If your team has multiple orders, note the order ID first to avoid connecting to the wrong device.

02

Account permissions

Make sure your console account can view the access details for this order. For shared orders, get authorization according to your team’s access policies, and don’t forward someone else’s credentials.

03

Local network

Check that your local network is working and that your organization’s network policy allows the connection method required by the order. Resolve local connectivity issues or client restrictions first.

04

Desktop client

Choose a compatible client for the connection method shown in your order, and check its address format. Don’t enter an address for one protocol into a client for another.

05

Keep access details secure

Store connection details only on trusted devices and in trusted credential managers. Before recording your screen, taking screenshots, or submitting a support ticket, hide addresses, usernames, and keys.

Connect in three steps

Use the details provided—don’t guess connection settings

Follow these steps; they don’t show a live order. Console fields and client interfaces may differ, so follow the instructions provided with your order.

01 / Authorization

Open the right order in the console

Check the node, connection method, address, and authorized credentials. If the order doesn’t show connection details as available, check its status first. Don’t try connecting with an address from another order.

What success looks likeYou can identify which machine you’re connecting to and which client to use.

02 / Connect

Enter the details in your client

Enter the address and credentials in the format shown in your order, then connect. If you see a certificate or identity prompt, verify its source. Don’t expose or share credentials to bypass a prompt.

What success looks likeThe client opens your authorized desktop session—not just a message saying the network is connected.

03 / Verify the desktop

Confirm the machine and work environment

Once on the desktop, check the machine details and permissions against your order. Then verify the macOS, Xcode, and command-line tool versions your project needs. Don’t treat example screenshots as the actual machine configuration.

What success looks likeYou can use the desktop and confirm that the current session belongs to the expected order.

If you need to share your screen with the support team, submit only redacted screenshots. Hide connection addresses, credentials, project keys, and any unrelated personal information from your order.

Connection methods

VNC is for interactive desktops—not the only connection option

VNC transmits the desktop display and receives keyboard and mouse input. It’s useful for checking graphical interfaces, handling steps that need manual confirmation, and viewing your development environment. It describes one way to interact with a desktop; it doesn’t mean every order provides VNC.

Check the actual protocols, client requirements, and authorized details for your order in the console. Don’t infer a fixed port, address, or connection performance from this illustration. For long-running build tasks, opening the desktop is just one step in preparing the environment. You’ll also need to configure dependencies, task permissions, and log retention.

Start by identifying the task

Need to see and interact with the desktop?
Use a remote desktop method supported by your order, then check that display and input work as expected.
Need to run builds continuously?
Configure the toolchain and task environment on the machine. Keeping a desktop window open isn’t enough.
Need to share access with your team?
Set clear rules for access, credential storage, and session handoffs before coordinating who does what.
Move from a local Mac

Move your project—and its verification steps

A successful connection doesn’t mean your development environment is ready. Migrate in three stages: data, toolchain, and automation tasks. Keep a local copy you can roll back to at each step, then verify the results on the cloud machine.

Local Mac → Cloud Mac · 01

Move your data

Gather your code, required project resources, and dependency list. Before transferring files, separate what needs to move from sensitive information that should stay local. Don’t put credentials in your code repository.

How to verifyOpen the project in the cloud, then check its directories, file permissions, and key resources. Keep the local copy for rollback.

Local Mac → Cloud Mac · 02

Install and verify the toolchain

Check the macOS, Xcode, command-line tools, and package dependencies required by your project. Note the local versions first, then install and verify each item in the cloud. Don’t assume both environments match.

How to verifyRun a reproducible dependency check and a local build of the project in the cloud.

Local Mac → Cloud Mac · 03

Connect CI tasks

Decide which account runs tasks, what minimum permissions it needs, how to store keys, and where build artifacts go. Start with a low-risk task, review the complete logs, then migrate your production workflow step by step.

How to verifyThe task runs when expected and produces a result. If it fails, you can use the logs to find the cause.

Session security

Treat access details like work credentials

A remote desktop gives you control of a physical machine. Protect connection details, manage team permissions, and end sessions you no longer need—these matter more than remembering where a client button is.

Use credentials only where authorized

Get details from your own order. Don’t share full addresses, passwords, or keys in chat, public posts, or screenshots. For collaboration, assign access through a secure channel approved by your team.

Assign access by role

Define who installs tools, runs builds, and manages project files. When people or responsibilities change, review access permissions and connection details saved in clients.

End sessions on shared devices

Close the remote desktop session, and check whether the shared computer has saved any credentials. Redact support materials before submitting them; never send content that could be used to log in.

Common issues

Note what happened, then troubleshoot

Specific symptoms make it easier to distinguish local network, client, permission, and machine environment issues. When submitting a support ticket, include the order ID, node, time, reproduction steps, and redacted screenshots—but no passwords or keys.

Can’t connect

Recheck the connection method for your order, address format, account permissions, and local network. Note the client’s error message, and don’t keep trying credentials from other orders.

Troubleshoot connection issues

Connected, but the display is slow or behaving oddly

Note your local network conditions, client settings, and what happened. Distinguish between unresponsive input, slow screen updates, and disconnected sessions; don’t infer a consistent latency from one experience.

Troubleshoot session issues

Desktop works, but the toolchain isn’t ready

Check your project requirements against the machine’s macOS, Xcode, command-line tools, and dependency versions. Save reproducible commands and error messages so you don’t mistake a build issue for a connection problem.

Check your environment
After connecting

Desktop ready? Set up your workflow next

For interactive Xcode development, team builds, or MLX experiments, check each task’s prerequisites first, then install software and manage permissions as your project requires. To check models, rental periods, or add-ons, view the plans. Manage existing orders and support tickets in the console.

Ready to rent a dedicated Mac?

Choose a physical node and rental period, then find the actual connection details in your order. Don’t use page illustrations as credentials.