# GarageWare

GarageWare is a self-hosted cloud app. Management console for a self-hosted Garage S3 cluster - buckets, access keys, node health, and a storage ledger for everyone sharing it. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/2516/garageware

## Description

Management console for a self-hosted Garage S3 cluster - buckets, access keys, node health, and a storage ledger for everyone sharing it. Garage gives you the storage; GarageWare gives you the front door: accounts, an object browser, S3 connection details, cluster status and per-node metrics, background repairs, and an append-only record of who is entitled to how much space. Runs as one container with one data path against a Garage cluster you already have.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

40/100 (Fair), based on 4 of 4 factors.
- Maintained: 76 (last commit 90 days ago)
- Popular: 0 (0 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Light to run: 20 (8 GB minimum RAM, runs on ARM)

## Links

- Docker Hub: https://hub.docker.com/r/dastron/garage-ware
- GitHub: https://github.com/make-ware/garage-ware
- Unraid: https://ca.unraid.net/apps/garageware-0j3gu280h5oo38?q=GarageWare

## Common questions

### Does GarageWare install Garage or only manage an existing cluster?

It manages a Garage S3 cluster you already run. It does not install Garage.

### Which environment variables must be set to connect GarageWare?

Set GARAGE_ADMIN_URL, GARAGE_ADMIN_TOKEN, and GARAGE_S3_ENDPOINT.

### What env-file name is required when starting GarageWare with plain Docker?

Save the example as .env.docker and start the container with --env-file .env.docker, not .env.

### How do I become the first administrator after startup?

The setup banner prints a URL and a one-time claim token. Open the URL, create your account, paste the token, and you land on /admin/status.

### How do I create the Garage admin token used by GarageWare?

Run garage admin-token create --name garage-ware on any Garage node.

### Where should I check when GarageWare cannot reach the cluster?

Open /admin/status, which names misconfigurations and fixes. If it cannot reach a cluster at all, it points to Garage install docs and an admin-only config generator.

---
Source: Our Local Host (https://ourlocalhost.com/app/2516/garageware), the self-hosted and open-source app directory.
