# Add/Remove

#### Add or remove a box from the local mapping.json file

Zeus uses 2 mapping files to unbox boxes. The `builtin-mapping.json` file is for boxes that are a part of the official zeus-sdk repo (located: `.../node_modules/@liquidapps/zeus-cmd/lib/resources/builtin-mapping.json`). This file only changes when Zeus is updated. There is also a local zeus box for modifying existing boxes from the `builtin-mapping.json` and adding new boxes. If a box exists in both the builtin and the local mapping files, the local mapping file will be used. To use the builtin box instead, you must remove the local version first.

### Zeus Box Add

{% tabs %}
{% tab title="Add" %}

```bash
zeus box add <BOX_NAME> <VERSION> <URI>
# zeus box add liquidx-jungle 1.0.1 https://s3.us-east-2.amazonaws.com/liquidapps.artifacts/boxes/0a98835c75debf2f1d875be8be39591501b15352f7c017799d0ebf3342668d2c.zip
```

{% endtab %}

{% tab title="Options" %}

```bash
zeus box <option> [name] [boxVersion] [uri]

Create, Add or Remove a Box

Options:
  --version       Show version number                                  [boolean]
  --storage-path  path for persistent storage    [default: "/home/ubuntu/.zeus"]
  --rc-file       use rc file to load options from
                                     [default: "/home/ubuntu/.zeus/zeusrc.json"]
  --rc-ignore     ignore rc file                                [default: false]
  --verbose, -v                                                 [default: false]
  -h, --help      Show help                                            [boolean]
  --light, -l     light npm dependencies for box                [default: false]

Examples:
  zeus box create
  zeus box add liquidx-jungle 1.0.0
  https://s3.us-east-2.amazonaws.com/liquidapps.artifacts/boxes/0a98835c75debf
  2f1d875be8be39591501b15352f7c017799d0ebf3342668d2c.zip
  zeus box remove liquidx-jungle 1.0.0
```

{% endtab %}
{% endtabs %}

### Zeus Box Remove

{% tabs %}
{% tab title="Remove" %}

```bash
# zeus list-boxes # will see new box under 'Local Boxes:'
zeus box remove <BOX_NAME> <VERSION>
# zeus box remove liquidx-jungle 1.0.1
# zeus list-boxes, will be gone
```

{% endtab %}

{% tab title="Options" %}

```bash
zeus box <option> [name] [boxVersion] [uri]

Create, Add or Remove a Box

Options:
  --version       Show version number                                  [boolean]
  --storage-path  path for persistent storage    [default: "/home/ubuntu/.zeus"]
  --rc-file       use rc file to load options from
                                     [default: "/home/ubuntu/.zeus/zeusrc.json"]
  --rc-ignore     ignore rc file                                [default: false]
  --verbose, -v                                                 [default: false]
  -h, --help      Show help                                            [boolean]
  --light, -l     light npm dependencies for box                [default: false]

Examples:
  zeus box create
  zeus box add liquidx-jungle 1.0.0
  https://s3.us-east-2.amazonaws.com/liquidapps.artifacts/boxes/0a98835c75debf
  2f1d875be8be39591501b15352f7c017799d0ebf3342668d2c.zip
  zeus box remove liquidx-jungle 1.0.0
```

{% endtab %}
{% endtabs %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.liquidapps.io/liquidapps-documentation/working-with-zeus-sdk/zeus-box-basics/add-remove.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.