# Workspaces

A **workspace** is your isolated “build room” inside AutoRABIT (ARM).\
Whenever you run an operation that needs local disk—such as **EZ-Commit**, a **merge** or a **CI job**—ARM spins up (or re-uses) a workspace linked to the repo/branch in question. That keeps files, temporary build artifacts, and logs separated per operation, so one task never overwrites another.

***

## What Is a Workspace? <a href="#what-is-workspace" id="what-is-workspace"></a>

Think of a workspace as a **containerized file system**:

* It’s created (or re-attached) automatically when you start a commit, merge, or CI task.
* Multiple workspaces can exist side-by-side—one per concurrent job.
* If a matching workspace already exists, the new job re-uses it to save spin-up time.

***

## Workspace Storage <a href="#workspace-storage" id="workspace-storage"></a>

* Every tenant receives **500 GB** of workspace capacity.
* ARM emails admins when usage approaches the limit.
* Once the cap is hit, no new jobs can start until you **increase the limit** or **delete idle workspaces**.

***

## Managing a Workspace <a href="#managing-workspace" id="managing-workspace"></a>

Only **Org Administrators** can view, reset, or delete workspaces.

### Viewing the Workspace List <a href="#viewing-the-workspace" id="viewing-the-workspace"></a>

1. Log in to ARM.
2. Go to **Settings › Workspaces**.<br>

   <figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FKu6l2uCilwrfWLt0z115%2Fimage.png?alt=media&#x26;token=c8517c6e-fa2e-4ffe-ac12-9d91e6b5c263" alt="" width="234"><figcaption></figcaption></figure>
3. The list shows every workspace ever created:\ <br>

   <figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FxPOM3di480aTKxwkiK1u%2Fimage.png?alt=media&#x26;token=c13785eb-9be1-4809-b640-01a829366183" alt=""><figcaption></figcaption></figure>

| Field                | Description                                           |
| -------------------- | ----------------------------------------------------- |
| **Label**            | Workspace name (auto-generated)                       |
| **Created On**       | Timestamp of first creation                           |
| **Author**           | User who owns the workspace                           |
| **Repo / Branch**    | Git location tied to the workspace                    |
| **Status**           | *Running* or *Idle*                                   |
| **Module**           | ARM feature that created it (EZ-Commit, CI Job, etc.) |
| **Last Used / Size** | Date of last activity and storage consumed            |

***

### Resetting a Workspace <a href="#reset-a-workspace" id="reset-a-workspace"></a>

Reset wipes the folder contents but keeps the workspace record.

1. Find the workspace and click **Reset**.
2. Confirm to restore default state.\ <br>

   <figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2F9bRkz8E17Z7MZ2G9ix7g%2FScreenshot%202025-08-16%20at%209.40.11%E2%80%AFPM.png?alt=media&#x26;token=9127eaff-7046-4042-8b75-e7d240d54c43" alt=""><figcaption></figcaption></figure>

***

### Deleting a Workspace <a href="#deleting-a-workspace" id="deleting-a-workspace"></a>

Delete removes the workspace permanently (repositories remain intact).

1. Click the trash-can icon next to the workspace.
2. Confirm twice—you cannot undo this.<br>

   <figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FBsmQlXNLevdl5m6Pzyhl%2Fimage.png?alt=media&#x26;token=f670d943-82e3-4ed0-a43e-82e675a4ffd5" alt=""><figcaption></figcaption></figure>

   <figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FjYxlJClpGISTz08GCVpg%2Fimage.png?alt=media&#x26;token=8eec947f-3dcd-46fc-b056-e813ea2d129b" alt="" width="375"><figcaption></figcaption></figure>

{% hint style="info" %}
If the **Delete** button is missing, your role lacks the required permission.
{% endhint %}

***

### Bulk-Deleting Inactive Workspaces <a href="#deleting-inactive-workspaces" id="deleting-inactive-workspaces"></a>

Free up space by purging all workspaces idle since a given date.

1. Click **Settings**.

   <figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FpHI7XRxWT2NnKFk8z0Qw%2Fimage.png?alt=media&#x26;token=0aeff56a-3fd1-4f9a-b70e-c697ba6b29c4" alt="Workspace Settings gear icon"><figcaption></figcaption></figure>
2. Choose the cutoff date and confirm.

   <figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FpMraW7oTbfSyvlReIyQn%2Fimage.png?alt=media&#x26;token=1b6e5a78-f350-4409-a4e0-5f4e616260d1" alt="Delete inactive workspaces dialog" width="418"><figcaption></figcaption></figure>

***

## Workspace Configurations <a href="#workspace-configurations" id="workspace-configurations"></a>

Need more space? An Org Admin can request an increase.

* Super Admin logs in and opens **Workspace Mgmt**.
* Raise the tenant limit—maximum **1 TB** (1000 GB)—based on subscription.

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FUyaz64TdibbK8aMoV9CO%2Fimage.png?alt=media&#x26;token=fe3c8d29-1224-4ede-bae2-33da50426110" alt="Super Admin screen showing workspace size adjustment"><figcaption></figcaption></figure>

Once approved, the new cap takes effect instantly and users can resume jobs without deleting old workspaces.

***

### Best Practices

* **Clean up idle workspaces weekly** to avoid hitting the limit.
* **Reset** instead of **Delete** if you just want a fresh working directory.
* Monitor the **Last Used / Size** column to spot abandoned, space-hogging workspaces early.