> ## 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.

# Run environment: on your device and cloud server

> The two ways a session can run: on your device (shown as Run on your device in the interface, where the agent remotely controls your computer) and on the cloud server. How to choose, machines and execution access, sensitive location confirmation, execution logs, reconnecting, and removing devices.

Each session picks a run mode when it starts, and the mode cannot be changed later:

* **On your device** (shown in the interface as **Run on your device**): the agent in the cloud remotely controls your computer. Reading and writing files and running commands happen on your computer, using your local environment and files, with the same result as running locally. You can choose any computer that is signed in to the desktop app and allows execution.
* **Cloud server**: the session runs from start to finish on your cloud server (the Linux cloud server included with Plus), without going through your computer. The session runs to completion even if you close your laptop.

## Availability

| Platform | Support | Notes |
| - | - | - |
| Desktop app | Supported | After you sign in, this computer automatically becomes a selectable device. You can change its execution access and handle sensitive location confirmations only in this computer's own app |
| Web app | Partial | New sessions can use the cloud server or any device; the machine list, execution access, and execution logs are view-only |
| Mobile web | Partial | Same as the web app |

## Comparison

| | On your device (Run on your device) | Cloud server |
| - | - | - |
| Where operations run | The computer you choose | Your cloud server (Ubuntu 24.04) |
| Environment and files used | The environment and project folder on that computer | The project copy on the cloud server and the [project environment](https://docs.aihubmix.com/en/cloud/projects/environment-setup.md) |
| Projects you can use | Local projects on that computer and sessions with no project | Cloud projects and sessions with no project |
| Supported agents | Only Claude Code for now | All |
| Requirements | The computer is online and **Allow execution** is on | The Plus plan |
| Computer shut down or offline | This turn pauses and continues automatically after the computer reconnects | Not affected |

## Entry points

* New session: the run environment button next to **Project** above the input box.
* Existing session: the run environment pill next to the title in the top bar.
* **Settings › Workspace › Machines**, or **Execution log** and **Machines & access** at the bottom of the run environment menu.

## Choose a run environment for a new session

Click the run environment button to open the **Run environment** menu: **Cloud server** is at the top; the **Run on your device** group below lists each device (the current computer is tagged **This device**, and the second line shows its access scope and permission limit); **Execution log** and **Machines & access** are at the bottom.

### Default selection

* A local project defaults to the computer where the project lives; other projects and sessions with no project default to the cloud server.
* A manual selection applies only to this new session. If the selected device becomes unusable, the selection falls back to the cloud server.

### When an option cannot be selected

| Reason | Text in the menu |
| - | - |
| The device is offline | **Device offline** (if the computer where a local project lives is offline, you can still select it, and it is marked **Device offline**) |
| **Allow execution** is not on for the device | **Not allowed to run** |
| The device was removed from the workspace | **Device removed. Choose another environment** |
| The current project is not on this device | **This project isn’t on this device** |
| The current agent is not Claude Code | **Running on a device supports only Claude Code for now** |
| Cloud server selected for a local project | **This project is only on this computer. Choose the device it’s on** |

### Device permission limit

Each device can have a **Permission limit**. When you select that device, levels above the limit in the session permission menu are grayed out (**Above this device’s permission limit**). If the selected permission is above the limit, it is lowered to the limit automatically. For permission levels, see [Input box](https://docs.aihubmix.com/en/cloud/sessions/composer.md).

## Run environment of an existing session

The pill next to the session title in the top bar shows **Cloud server** or the name of the execution device. When the device is offline, it shows **Device offline**.

* The execution machine is chosen when the session is created and cannot be changed later. To use a different machine, create a new session.
* **Execution log** and **Machines & access** at the bottom of the menu open the execution device's log and details.

## Devices and the machine list

A **device** is a computer where you are signed in to the desktop app. After you sign in, it joins the workspace automatically and appears in the machine list and the run environment menu. The web app does not add devices.

**Settings › Workspace › Machines** lists all machines in the workspace (the cloud server first). Each row shows the name, OS and app version, and a status: **Online**, **Offline**, **Stopped (retained)**, or **Removed**. Offline records with the same name left behind after reinstalling the app are collapsed into one line; open one to remove it if you no longer use it.

Click a row to open the machine details.

## Machine details and execution access

Computers and servers can be renamed with the pencil next to the name (up to 64 characters).

| Group | Setting | Values (default) | Details |
| - | - | - | - |
| Execution access | Allow execution | On / Off (off by default for computers) | Cloud agents can run on this machine only when it is on |
| Execution access | Access scope | **Project folder only**, **Selected folders**, **Entire computer** (default: entire computer) | With **Selected folders**, add the allowed folders |
| Execution access | Sensitive locations | **Ask each time** (default), **Block access**, **Allow access** | For example, SSH, keychains, and system settings |
| Task permissions | Permission limit | **No limit** (default), **Approve for me**, **Ask for approval** | Session permissions cannot exceed this limit |
| Task permissions | Secrets that can be sent | **All workspace secrets** (default), **Selected secrets only** | Choose which workspace secrets can be used on this machine |
| Environment variable overrides | Variable list | None | Environment variables overridden when running on this machine; do not enter plaintext secrets, use a `${VAR}` reference instead |
| Execution log | **View execution log** | None | See below |
| Plugins and Skills | **Manage this device’s plugins** | None | See [Plugins, MCP, and Skills](https://docs.aihubmix.com/en/cloud/integrations/plugins-mcp-skills.md) |
| Device management | **Remove device** | None | See below |

* Saved changes apply to new sessions immediately.
* The cloud server's details show only **Allow execution** (read-only), the execution log, and the plugins entry. It cannot be renamed or removed.

### System confirmation

When you widen this computer's execution access in the desktop app (turning on **Allow execution**, widening the access scope, opening sensitive locations, raising the permission limit, and so on), a confirmation dialog lists what is being widened. Once **Allow execution** is on, it applies to every future session that runs on this computer. Narrowing access needs no confirmation; when you turn off **Allow execution**, sessions using this device pause.

### Who can make changes

Execution access can be changed only in **this computer's own desktop app**. When viewed on another device or in the web app, it is read-only, with **Execution access can only be changed on this device.** The cloud server's settings are also read-only.

## First run on this computer

When a session is set to run on this computer but this computer does not yet meet the requirements, this computer's app shows a prompt when it opens the session:

* **Allow execution is not on yet**: click **Open Machines & access**, turn on **Allow execution**, then come back. Commands run with your account's permissions.
* **The project has no folder on this computer yet**: click **Allow** and choose the project's folder on this computer; you will not be asked again for this project. Click **Don’t allow** and this project will not run on this computer. The folder is not synced to the cloud.

Sessions with no project use the session's own temporary folder. When applicable, the dialog notes that your `~/.claude/CLAUDE.md` is also sent to the Agent.

## Sensitive location confirmation

When a device's **Sensitive locations** setting is **Ask each time** and the agent needs to access a location such as the SSH configuration, the execution device's app first shows an **Access request** card with the reason and the path to be accessed:

* **Allow once**: grants access this one time, without changing machine access.
* **Deny**: access is not granted.
* If you do not respond within a set time, it is treated as denied.
* You can click **Later** to collapse it; the session in the sidebar then shows **Needs your input**.

## Execution log

Open it from **Execution log** in the run environment menu (this session) or **View log** in machine details (all sessions on this machine). It lists the agent's operations on this machine one per row, with the target and result.

In the execution device's own app, you can also use **Stop processes** (ends operations in progress and background processes), **Disconnect**, and **Reconnect**. In the web app or on other devices, you can only view the log.

## Disconnects and reconnecting

When a session is running on a computer and that computer disconnects (shut down, asleep, offline, app closed, and so on):

* The turn pauses, and the execution device's app shows **This computer disconnected. This turn is paused.** at the end of the session, with the reason for the disconnect.
* After the connection recovers, it continues automatically from where it was interrupted, and completed operations do not run again. You can also click **Reconnect**. If the reason is that execution is not allowed or the project folder is not linked, you are guided to fix it.
* On other devices and the web app, the session pill shows **Device offline**.

A session does not switch to the cloud server automatically when its device goes offline.

## Remove a device

At the bottom of machine details, click **Remove device** and confirm. The device disconnects immediately, and sessions using it are interrupted. To use it again later, sign in again on that device.

* The cloud server cannot be removed.
* The current computer cannot be removed here. Sign out to remove it.

## Cloud server mode

When you choose **Cloud server**, the session runs entirely on your cloud server, and the project uses the copy on the cloud server and the [project environment](https://docs.aihubmix.com/en/cloud/projects/environment-setup.md). The cloud server requires Plus; without it, **Cloud server** in the menu shows **Available with Plus**. For getting a cloud server, its status, and the remote desktop, see [Cloud server](https://docs.aihubmix.com/en/cloud/cloud-host/overview.md).

## FAQ

### With **Run on your device**, does my computer need to stay on?

Yes. If the computer disconnects, the turn pauses and continues automatically after it reconnects. If you need the session to keep running after you close your laptop, choose the cloud server.

### Can an existing session move from my computer to the cloud server?

No. The execution machine is set when the session is created. To change it, create a new session.

### Why can't I change my computer's access in the web app?

Execution access can be changed only in that computer's own desktop app.

### How do I add a new device?

Install the desktop app on that computer and sign in with the same account. It appears in the machine list automatically. Then turn on **Allow execution** in that computer's app.

## Related

* [Projects](https://docs.aihubmix.com/en/cloud/projects/projects.md)
* [Project environment](https://docs.aihubmix.com/en/cloud/projects/environment-setup.md)
* [Workspace settings](https://docs.aihubmix.com/en/cloud/settings/workspace.md)
* [New session](https://docs.aihubmix.com/en/cloud/sessions/new-session.md)
* [Input box](https://docs.aihubmix.com/en/cloud/sessions/composer.md)
* [Plugins, MCP, and Skills](https://docs.aihubmix.com/en/cloud/integrations/plugins-mcp-skills.md)
* [Cloud server](https://docs.aihubmix.com/en/cloud/cloud-host/overview.md)


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