> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aihubmix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Cloud server

> The cloud server is a dedicated Linux machine included with Plus. Learn what it can do, how to view and take control of the remote desktop, choose an egress region, and set admin access.

The **cloud server** is a dedicated Linux machine included with Plus. The Agent uses it to run your sessions and scheduled tasks. If you close the client or shut your laptop, sessions on the cloud server keep running to completion. If you want the Agent to use the environment and files on your own computer, see [Run on your device](https://docs.aihubmix.com/en/cloud/environments/your-device.md).

## Cloud server and Plus

Each account has one cloud server. It is available only with a Plus subscription and is not sold separately. Subscribing to Plus sets up your cloud server, which usually takes a few minutes. For pricing, renewal, and cancellation, see [Plus plan and usage](https://docs.aihubmix.com/en/cloud/account/plus.md).

There is currently one configuration: Linux (for example Ubuntu 24.04 LTS, as shown in the app), 4 vCPU, and 8 GB of memory. Storage capacity and monthly outbound traffic are shown on the cloud server page. You cannot upgrade the configuration, add storage, or change the operating system.

## View and manage on the cloud server page

In the desktop app, click **Cloud server** in the left icon bar. In the web app, click **Cloud server** at the bottom of the sidebar. On this page you can:

* See a thumbnail of the cloud server's current screen, and click **Open desktop** to view it full screen.
* Check the system and specs, the running status, and how many sessions are running.
* Check the region and egress IP (copy it with one click), storage and traffic usage, the monthly fee, and the next renewal date.
* Click **View billing**. For subscriptions paid online, you can also click **Payment & invoices** to change your card or download invoices, or click **Cancel renewal** / **Resume renewal**.

![Cloud server page](https://mintcdn.com/aihubmix/ADcIS2RBGw_ogRXt/images/cloud/en/cloud-host.png?fit=max\&auto=format\&n=ADcIS2RBGw_ogRXt\&q=85\&s=18ac1e4b290439dcd6f82784f1f06931)

Cloud server page: specs, region and egress IP, usage, and renewal details

Do not store passwords or keys in plain-text files on the cloud server. Put them in **Settings › Workspace › Secrets & variables** instead. See [Projects and environment setup](https://docs.aihubmix.com/en/cloud/environments/projects.md).

## Choose an egress region

The **egress region** is where the egress IP is located when the Agent accesses the internet. It affects access speed and which services you can reach. You choose a region when you subscribe to Plus. Each region shows the latency measured from your current network, and regions that are temporarily sold out cannot be selected.

> [!WARNING]
>
> You cannot change the egress region after setup. Choose it before you subscribe.

## Watch what the Agent does on the cloud server

The remote desktop shows what is happening on the cloud server's screen in real time. By default it is view only.

**1. Open the remote desktop**

In the session top bar, click the **Cloud server** button, or press `` ⌃` `` (Windows: `` Ctrl+` ``). The right panel shows the live screen, the egress IP, and the region.

**2. View full screen**

Click the full-screen button in the right panel, or press `⇧⌘F` (Windows: `Ctrl+Shift+F`). Clicking **Open desktop** on the cloud server page opens it full screen directly.

**3. Exit full screen**

Press `Esc` or click **Exit full screen**. When focus is inside the remote desktop, `Esc` is sent to the cloud server, so click **Exit full screen** instead.

![Cloud server remote desktop](https://mintcdn.com/aihubmix/ADcIS2RBGw_ogRXt/images/cloud/en/cloud-desktop.png?fit=max\&auto=format\&n=ADcIS2RBGw_ogRXt\&q=85\&s=822a0fcfc18f0359ff341f794a6484ca)

Viewing the cloud server desktop in the right panel

If the screen disconnects or cannot connect, the Agent keeps working on the cloud server. You just cannot see the screen for the moment. You cannot copy content from the remote desktop while viewing only.

Remote desktop traffic is counted per day and resets at 00:00 UTC. Usage is shown on the cloud server page. Up to 3 desktop views can be open at the same time for one cloud server. Running out of desktop traffic only affects the screen, not the Agent or your sessions. For connection issues, see [FAQ and troubleshooting](https://docs.aihubmix.com/en/cloud/reference/troubleshooting.md).

## Take control of the cloud server

When you need to do something yourself (for example sign in to a website or enter a two-factor code), you can take control of the keyboard and mouse.

**1. Click Take control**

Click **Take control** at the top of the right panel or the full-screen view. If any sessions are running on the cloud server, they are listed first for you to confirm.

**2. Do what you need**

Work directly in the screen. The top shows how long you have been in control.

**3. Hand back keyboard and mouse**

Click **View only** to return the screen to read-only. It also returns to read-only automatically after 30 minutes without input or when the connection drops.

> [!WARNING]
>
> Taking control does not pause the Agent. The Agent keeps running, and your actions may happen at the same time as its actions. If you need the Agent to wait for you, have it ask you in the session, or stop the current task first.

* If you take control in another window or on another device, this view returns to read-only automatically. Click **Take control** again when you need it.
* When you finish, every session that ran during your control gets a record, and the Agent knows you used the desktop the next time you send a message.
* When the Agent reaches a step only you can complete, it asks you above the input box. Click **Take control** to take over directly, then click **Resolved** when you are done. See [Work with the Agent](https://docs.aihubmix.com/en/cloud/sessions/work-with-agent.md).

> [!NOTE]
>
> The mobile web app can only view the remote desktop. It cannot take control.

## Turn admin access on or off

**Admin access on cloud server** controls whether the Agent can install system software and change system settings on the cloud server. It is on by default and applies to the whole cloud server.

**1. Find the switch**

Open **Settings › Workspace › Overview** and find **Admin access on cloud server** in the cloud server group.

**2. Switch and confirm**

Turning it on lists the risks. Click **Got it, turn on** to save. To turn it off, just switch it off.

**3. Wait for it to apply**

The actual status on the cloud server appears below the switch. It usually takes less than 1 minute. If applying fails, click **Retry**.

Before you turn it on, note the following: the Agent can read credentials saved on the cloud server; approvals and branch restrictions become recommendations and are no longer enforced; turning it off does not undo changes already made, and accidental changes to system files may require rebuilding the cloud server.

Because it is on by default, the same risk confirmation appears the first time you start a session on the cloud server. Click **Got it, start the task** to start the session, and you will not be asked again. Click **Cancel** and the message is not sent. If you have already confirmed in settings or turned admin access off, the confirmation does not appear.

## Network restrictions

The cloud server can only access the public internet. It cannot reach your internal network. If a custom model endpoint you set up in [BYOK](https://docs.aihubmix.com/en/cloud/models/model-sources.md) is on an internal network, switch to an address that is reachable from the public internet.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.