> ## 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 admin access

> Cloud server admin access determines whether the Agent can install software and change system settings on the cloud server. This page covers where the toggle is, the risk confirmation, the current state, and the confirmation the first time you start a session on the cloud server.

**Cloud server admin access** determines whether the Agent can act as an administrator on the cloud server, for example installing system software or changing system settings. It is **on by default** and applies to the whole cloud server.

## Entry points

* The **Cloud server** group in **Settings › Workspace › Overview** (available in the desktop app, web app, and mobile web).
* The first time you start a new session on the cloud server, a risk confirmation appears automatically (see below).

## Turn on and off

The **Cloud server** group has the **Admin access on cloud server** toggle. The **Current state** row below it shows the state actually in effect on the cloud server.

**Turn on**:

1. Turn on the toggle. The **Turn on admin access on cloud server** confirmation appears, listing four risks:
   * The agent gets admin access on the cloud server and can read credentials stored there.
   * Approvals and branch limits become advisory, not enforced.
   * Turning it off doesn’t undo changes already made. To fully reset, rebuild the cloud server.
   * There’s no automatic repair yet. Breaking system files may mean rebuilding the cloud server.
2. Click **Got it, turn on** to save, or **Cancel** to make no changes.

**Turn off**: just turn off the toggle. No confirmation is needed. Turning it off does not undo changes the Agent made earlier on the cloud server.

After saving, the current state first shows **Applying** and usually takes effect within a minute.

## Rules and states

| Current state | What you can do |
| - | - |
| **In effect** / **Off** | Switch the toggle as needed |
| **Applying** | Wait a moment. The toggle cannot be changed during this time |
| **Failed** (the cloud server keeps its previous state) | Click **Retry** |
| **Cloud server needs an upgrade** | Nothing to do. The platform upgrades it automatically at the next maintenance |
| **No cloud server yet. These settings apply once you get one.** | Switch the toggle as usual. The setting is applied after you get [Plus](https://docs.aihubmix.com/en/cloud/plus/plus-plan.md) |

## Confirmation the first time you start a session on the cloud server

Admin access is on by default, so the first time you start a session on the new session page with the cloud server run mode, the same risk confirmation appears first, with the buttons **Cancel** and **Got it, start the task**.

* Click **Got it, start the task**: the session starts immediately. You are not asked again.
* Click **Cancel**: the message is not sent.

It does not appear if you already confirmed the risks in settings or have turned admin access off. On another device, or after clearing browser data, you may need to confirm once more. For the new session flow, see [New session](https://docs.aihubmix.com/en/cloud/sessions/new-session.md).

## Notes and limitations

* When it is on, the Agent can read credentials stored on the cloud server. Put secrets the Agent needs in **Settings › Workspace › Secrets & variables**, and do not keep them in plain-text files on the cloud server.
* Turning it off does not roll back existing changes. There is currently no automatic repair for system files.

## FAQ

### I turned off admin access. Why does it still show "In effect"?

After the toggle is saved, it takes a moment to take effect on the cloud server. Until then it shows **Applying**, usually for less than a minute. If it changes to **Failed**, click **Retry**.

### Is admin access set per project?

No. It applies to the whole cloud server and is in the workspace settings.

## Related

* [Cloud server overview](https://docs.aihubmix.com/en/cloud/cloud-host/overview.md)
* [New session](https://docs.aihubmix.com/en/cloud/sessions/new-session.md)
* [Workspace settings](https://docs.aihubmix.com/en/cloud/settings/workspace.md)


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