Set up your Mac

After linking: SSH first, apps next

Open your newly linked Mac in the panel. First, connect over SSH is the main next step. Choose SSH keys & setup to add the connecting computer’s public key, or Connect your AI assistant to authorize an agent to prepare SSH and install an app. No domain is needed for SSH.

Wait for confirmed SSH details and use the trusted host identity before connecting. Then install and start the app you want to host. MacServe detects it and offers public-connection setup; connect a domain only when your website is ready. Existing Macs with published apps keep their websites first. The local terminal in the Mac app remains available as an alternative.

Before you begin

You need an Apple silicon Mac with macOS 13 or later, at least 8 GiB of memory and 10 GiB of free disk space. Intel Macs are not supported. Your Mac must remain awake, online and signed in while hosting.

Public signup is not open yet. Use the account invitation provided to you. This early-access app is not yet notarized by Apple; if macOS blocks it, contact your inviter. Do not disable your Mac’s security settings.

Install and connect

You can sign in before installing, or install first. The latest app asks for account approval before creating Linux. Older eight-character pairing codes remain a recovery fallback.

1. Download the ZIP, open it, and move MacServe.app into Applications. Open it there.
2. Choose CPU and memory in the app, then Create your server. For an existing server choose Connect your Mac; existing files and resources are preserved.
3. Open the setup link from the app. Sign in, compare the Mac name and code, and approve the selected Mac. Only the local app holds the device credential; the browser receives a short-lived setup reference.
4. Keep the Mac online while Linux downloads and starts. The app links it automatically. If interrupted, reopen the app and resume. An expired link needs fresh approval for the same account, not a new VM.
5. The first successfully linked Mac starts the account’s 7-day/1-GB trial. Choose Connect your AI assistant, or Continue manually to prepare SSH and your first app.

Follow the same progress on both screens

App version 0.2.1 and the panel show the same pairing card: Approve, Prepare, Connect, Ready. Check the Mac name, resources and code before approving. After approval, the code and approval button disappear. Preparing your server can take several minutes; stay on either screen while the app works automatically.

Your Mac is linked means account setup has finished, not that SSH or a website is already public. Choose Connect your AI assistant or Continue manually in the panel for those next steps. If status cannot be checked, the panel shows a connection interruption and retries. If the app reports a problem, resume there; don’t delete your server or start a second setup.

An older installed app keeps its old interface until upgraded. Updating the website alone cannot update your Mac app. Finish any active setup before replacing the app; keep your existing server, files and SSH keys.

Your first app

Choose Open terminal in MacServe to work inside Linux. Install and run your application there, then open Public access in the panel and choose Connect an app. MacServe detects listening apps automatically. Choose Website or API, then Connect domain; choose Other app for a TCP/UDP connection.

No Docker is required. MacServe gives you one Linux VM; you decide what to install and how to restart your applications. Your Mac’s folders are not automatically shared with Linux.