OpenC3/cosmos

---
title: Bucket Explorer
---

## Introduction

Bucket Explorer is a file browser to the COSMOS backend bucket storage system. It allows you to view files in an intuitive file browser hierarchy and download them. Bucket Explorer works both with local installations of COSMOS as well as cloud deployments which utilize cloud storage such as AWS S3 and GCP Cloud Storage.

![Bucket Explorer](/img/bucket_explorer/bucket_explorer.png)

## Browsing Files

At the top are the three standard COSMOS buckets: `config`, `logs`, and `tools`. Each bucket contains top level folders named after the scope. In the Open Source edition the only scope is `DEFAULT`. The `config` bucket holds the COSMOS configuration which is populated as plugins are installed. The `logs` bucket holds the COSMOS logs which are generated by the various COSMOS microservices (See [Logging](../guides/logging.md) for more info). These logs are gzipped to save storage space. The `tools` bucket holds the source code for the built-in COSMOS tools as well as user created tools installed as plugins. Note that the search box only searches the current screen worth of files, e.g. it does not search the entire bucket.

:::note Tools as Static Website
Using bucket storage allows COSMOS to directly serve the tools as a static website and thus it must be a public bucket in cloud technology like S3
:::

### Upload

Click the Upload icon to bring up a file browser to select a file to upload into the current bucket and path. Note that in [COSMOS Enterprise](https://openc3.com/enterprise) you can only upload files to the config/DEFAULT/targets_modified folder unless you're an Admin.

### Download

Click the Download icon to download any of the individual files from any bucket and path.

### Delete

Click the Trash icon to delete an individual file. Note that in [COSMOS Enterprise](https://openc3.com/enterprise) you can only delete files in the config/DEFAULT/targets_modified folder unless you're an Admin.