52 lines
1.8 KiB
Markdown
52 lines
1.8 KiB
Markdown
---
|
|
created: 2026-09-05
|
|
modified: 2026-09-05
|
|
type: reference
|
|
client: sam
|
|
project: web-host-migration
|
|
status: active
|
|
priority: 2
|
|
tags:
|
|
- garage
|
|
- s3
|
|
- webui
|
|
- visualization
|
|
aliases:
|
|
- garage-webui-handoff
|
|
id: 1848129029-GUI
|
|
---
|
|
# Garage Web UI — handoff + reference
|
|
|
|
> Handoff for adding a web UI to view/manage **Garage** (local S3, family-home-lab on .13).
|
|
> Do NOT use for AWS S3 offsite (separate system — see status page for that).
|
|
|
|
## Tool choice
|
|
- **Image:** `khairul169/garage-webui:latest` — works with **Garage v1.x** (yours is **v1.0.1**).
|
|
- **Skip** `Noooste/garage-ui` for now (requires Garage **2.0+**; would need a Garage upgrade first).
|
|
|
|
## Garage facts (from `/home/sam/Docker/Containers/family-home-lab/garage.toml`)
|
|
- Admin API: `[::]:3902` (host 3902), **admin_token = GARAGE_ADMIN_TOKEN** (in `.env`, NOT the checked-in placeholder)
|
|
- S3 API: `[::]:3900`, s3_region = `garage`
|
|
|
|
## Deploy (on .13, alongside garage)
|
|
```bash
|
|
docker run -d --name garage-webui --restart unless-stopped -p 3909:3909 \
|
|
-v /home/sam/Docker/Containers/family-home-lab/garage.toml:/etc/garage.toml:ro \
|
|
-e API_BASE_URL=http://127.0.0.1:3902 \
|
|
-e S3_ENDPOINT_URL=http://127.0.0.1:3900 \
|
|
khairul169/garage-webui:latest
|
|
```
|
|
- Access: `http://192.168.20.13:3909` (or Caddy: `garage-ui.lab.audasmedia.com.au` behind basic-auth)
|
|
- Browser to S3 API may need the admin token (from .env).
|
|
|
|
## Reference
|
|
- https://github.com/khairul169/garage-webui
|
|
- Garage v1.x docs: https://garagehq.deuxfleurs.fr/
|
|
|
|
## Notes
|
|
- Garage = local S3 store for family-home-lab (portal media etc). Not the AWS offsite.
|
|
- AWS offsite status = `https://offsite.lab.audasmedia.com.au` (separate).
|
|
- Grafana (on .35) currently has NO data sources — deferred consolidation candidate only.
|
|
|
|
---
|
|
*Part of the migration project. Track in [[Migration Work Log]].* |