> For the complete documentation index, see [llms.txt](https://docs.liquidapps.io/liquidapps-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.liquidapps.io/liquidapps-documentation/working-with-zeus-sdk/zeus-box-basics/add-remove.md).

# 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 %}