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

# Settings › Workspace: overview, secrets and environment variables, projects

> Workspace settings: Overview, Secrets & variables (project-level and shared by all projects, bulk adding), and the project list with the entry to project settings.

A **workspace** is the scope that projects, sessions, secrets and environment variables belong to. The **Workspace** group in the **Settings** navigation contains **Overview**, **Machines**, **Secrets & variables**, **Projects** and **Archived chats**. This page covers Overview, Secrets & variables and Projects. For Machines, see [Run environment: on your device and cloud server](https://docs.aihubmix.com/en/cloud/projects/run-environment.md). For Archived chats, see [Archived chats](https://docs.aihubmix.com/en/cloud/settings/archived.md).

## Availability

Supported in the desktop app, web app and mobile web. On mobile web, the settings navigation becomes a grouped list that opens details.

## Where to find it

Account menu › **Settings**, the **Workspace** group in the left-side navigation.

## Overview

| Row | Shows | Action |
| - | - | - |
| Workspace name | The current name, or **Untitled** if there is none | **Edit** |
| Projects | **N projects** | **View** opens **Settings › Workspace › Projects** |
| Members | A personal workspace shows **Just you · owner**; a team workspace shows **Team workspace · member management coming soon** | None |

When renaming, names are 1–64 characters and cannot be empty.

### Admin access on cloud server

Below **Overview** is the **Admin access on cloud server** switch (when on, the agent can install software and change system settings on the cloud server; on by default) and its current state. See [Cloud server admin access](https://docs.aihubmix.com/en/cloud/cloud-host/admin-permission.md).

## Secrets & variables

The page has two parts:

* **Projects**: one group per project, showing the project name, source and a summary (such as **2 variables · 1 secret**).
* **All projects**: workspace level, applies to every project.

Rules:

* When names match, the project's value wins. The **All projects** value is used only when the project has no item with the same name. Items in a project group that override a workspace item are labeled **Overrides workspace**, and items in the workspace group that projects override are labeled **Overridden in N projects**.
* Secrets are stored encrypted, and the AI cannot see the original values. Secret values are shown as dots in the interface.
* The upper-right corner of each group has **Bulk add** and **Add secret or variable**. Each row has edit and delete buttons. Deleting has no confirmation.

### Add or edit

| Field | Description |
| - | - |
| Name | Converted to uppercase automatically, with spaces replaced by underscores, for example `API_BASE_URL`; cannot be changed when editing |
| Value | Required. When editing, the original value is hidden and you enter a new value to replace it |
| Type | **Variable** (default) or **Secret** |

### Bulk add

Click **Bulk add** and write one `KEY=value` per line. You can paste the contents of a `.env` file directly, and items with the same name are replaced:

* Names that contain KEY, TOKEN, SECRET or PASSWORD are saved as secrets. All others are saved as variables.
* Empty lines and lines starting with `#` are ignored. The `export KEY=value` form also works. Matching quotes around a value are removed.
* Names can contain only letters, digits and underscores, cannot start with a digit, and can be up to 64 characters. Values cannot be empty. The same name cannot appear on two lines.
* Invalid lines stay in the text box marked **Line N: reason**. All other lines are saved as usual.

### Where secrets are used

* Project environments on the cloud server: values follow the same-name priority rule above.
* When running on your device: the device's **Allowed secrets** determine which workspace secrets are provided to that computer. See [Run environment: on your device and cloud server](https://docs.aihubmix.com/en/cloud/projects/run-environment.md).
* When the AI finds missing secrets and variables while setting up the environment, it asks you to fill them in during the [environment check](https://docs.aihubmix.com/en/cloud/projects/environment-setup.md), and the results are also saved here.

## Projects

**Settings › Workspace › Projects** lists all projects in the workspace. Each row shows the name, source (GitHub repository or folder), status (such as **Environment not set up**, **Setup failed** or **This computer only**) and the number of variables. Click a row to open the project page, or click the gear at the end of the row to open the project settings directly. For what each status means, see [Project environment](https://docs.aihubmix.com/en/cloud/projects/environment-setup.md) and [Projects](https://docs.aihubmix.com/en/cloud/projects/projects.md).

## Project settings

You can open an individual project's settings from the gear in the project list, **Project settings** in the upper-right corner of the project page, or **Edit** in the project menu:

| Area | Contents | When changes take effect |
| - | - | - |
| Project info | Name, description, repository or source folder, base branch, commit method, commit author, additional cloned repositories | After you click **Save**; you can **Discard** |
| Environment | Setup script, start command | After you run it again and publish |
| Secrets & variables | Project-level items, plus items **Inherited from workspace** | Deletions take effect immediately; add and edit items in **Settings › Workspace › Secrets & variables** |
| Delete project | **Delete project…** | Immediately after you confirm |
| Export project | **Download project archive** | The download starts when you click |

For details, see [Projects](https://docs.aihubmix.com/en/cloud/projects/projects.md) and [Project environment](https://docs.aihubmix.com/en/cloud/projects/environment-setup.md).

## FAQ

### If a project and the workspace both have a variable with the same name, which one is used?

The project's value. The **All projects** value applies only when the project has no item with the same name.

### Can the AI see the secrets I enter?

No. Secrets are stored encrypted. The interface and chat show only their names, and the values are provided to the environment at run time.

## Related

* [Projects](https://docs.aihubmix.com/en/cloud/projects/projects.md)
* [Project environment](https://docs.aihubmix.com/en/cloud/projects/environment-setup.md)
* [Run environment: on your device and cloud server](https://docs.aihubmix.com/en/cloud/projects/run-environment.md)
* [Cloud server admin access](https://docs.aihubmix.com/en/cloud/cloud-host/admin-permission.md)
* [Archived chats](https://docs.aihubmix.com/en/cloud/settings/archived.md)


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