matiasft/garage-ui-armv7 repository overview

⁠Garage UI — ARMv7 build

Web dashboard for Garage⁠ S3-compatible object storage, built for linux/arm/v7 (32-bit ARM).

This is an architecture-specific build of Noooste/garage-ui⁠. The upstream image (noooste/garage-ui) only ships linux/amd64 and linux/arm64 — this repo covers 32-bit ARM devices, such as:

• QNAP NAS with Annapurna Labs Alpine AL314 (ARM Cortex-A15), e.g. TS-x31 series
• Raspberry Pi 2 / 3, or any Pi running a 32-bit OS
• Other ARMv7 boards (Odroid, BeagleBone, etc.)

⁠Features

• Bucket management: create, configure, and browse buckets with drag-and-drop uploads
• Access key management with per-bucket permissions
• Cluster overview: node status, layout, storage usage
• Flexible auth: none, basic credentials, admin token, or OIDC
• Inline preview of images, video, PDF, and text
• Runs as non-root (uid 1000) with a built-in /health healthcheck

⁠Tags

⁠Quick start

docker run -d --name garage-ui \
  -p 8080:8080 \
  -v /path/to/config.yaml:/app/config.yaml:ro \
  matiasft/garage-ui-armv7:latest

Minimal config.yaml:

server:
  port: 8080

garage:
  endpoint: "http://garage:3900"
  admin_endpoint: "http://garage:3903"
  admin_token: "your-admin-token"
  region: "garage"

Then open http://<host>:8080.

⁠Docker Compose

services:
  garage-ui:
    image: matiasft/garage-ui-armv7:latest
    ports:
      - "8080:8080"
    volumes:
      - ./config.yaml:/app/config.yaml:ro
    restart: unless-stopped

⁠Configuration via environment variables

Any config value can be overridden with the GARAGE_UI_ prefix:

GARAGE_UI_SERVER_PORT=8080
GARAGE_UI_GARAGE_ENDPOINT=http://garage:3900
GARAGE_UI_GARAGE_ADMIN_ENDPOINT=http://garage:3903
GARAGE_UI_GARAGE_ADMIN_TOKEN=your-token

Secrets can be loaded from files with the _FILE suffix (e.g. GARAGE_UI_GARAGE_ADMIN_TOKEN_FILE=/run/secrets/token).

See config.example.yaml⁠ for all options (auth, CORS, logging).

⁠Requirements

• A running Garage cluster (v2.1.0+ recommended) with the admin API enabled
• In garage.toml: [admin] api_bind_addr and admin_token set

⁠Source & license

• Upstream project: https://github.com/Noooste/garage-ui⁠ (MIT license)
• Built from the upstream Dockerfile with docker buildx build --platform linux/arm/v7