{"name":"Garage Web UI: An Admin Interface for Garage Object Storage","description":"Garage Web UI is a simple, self-hosted web interface designed for managing the Garage Object Storage service. Built with TypeScript and Go, it provides essential features like health status monitoring, bucket management, and access key creation. This tool simplifies the administration of your S3-compatible distributed object storage.","github":"https://github.com/khairul169/garage-webui","url":"https://osrepos.com/repo/khairul169-garage-webui","source":"osrepos.com","sourceDescription":"This repository profile is provided by osrepos.com, an open source repository discovery platform.","repositoryProfile":"https://osrepos.com/repo/khairul169-garage-webui","generatedFor":"open source discovery and AI-assisted research","markdown":"https://osrepos.com/repo/khairul169-garage-webui.md","json":"https://osrepos.com/repo/khairul169-garage-webui.json","topics":["TypeScript","Go","WebUI","Object Storage","S3","Admin Panel","Self-hosted","Docker"],"keywords":["TypeScript","Go","WebUI","Object Storage","S3","Admin Panel","Self-hosted","Docker"],"stars":null,"summary":"Garage Web UI is a simple, self-hosted web interface designed for managing the Garage Object Storage service. Built with TypeScript and Go, it provides essential features like health status monitoring, bucket management, and access key creation. This tool simplifies the administration of your S3-compatible distributed object storage.","content":"## Introduction\n\nGarage Web UI is an intuitive, self-hosted web interface designed to simplify the administration of [Garage](https://garagehq.deuxfleurs.fr/) (target=\"_blank\"), a powerful S3-compatible, distributed object storage service. This project provides a user-friendly dashboard for managing your Garage cluster, making complex operations accessible through a graphical interface.\n\nKey features include:\n\n*   Monitoring Garage health status.\n*   Managing cluster and layout configurations.\n*   Creating, updating, and viewing bucket information.\n*   An integrated objects/bucket browser for easy navigation.\n*   Creating and assigning access keys for secure access.\n\nBuilt with TypeScript for the frontend and Go for the backend, Garage Web UI offers a robust and responsive experience for managing your object storage infrastructure.\n\n## Installation\n\nGarage Web UI can be easily deployed using Docker, Docker Compose, or as a standalone binary.\n\n### Using Docker CLI\n\nTo quickly get started with Docker, run the following command:\n\nsh\ndocker run -p 3909:3909 -v ./garage.toml:/etc/garage.toml:ro --restart unless-stopped --name garage-webui khairul169/garage-webui:latest\n\n\n### Using Docker Compose\n\nIf you are already running Garage with Docker Compose, you can integrate the Web UI by adding it to your `docker-compose.yml` file:\n\nyml\nservices:\n  garage:\n    image: dxflrs/garage:v2.0.0\n    container_name: garage\n    volumes:\n      - ./garage.toml:/etc/garage.toml\n      - ./meta:/var/lib/garage/meta\n      - ./data:/var/lib/garage/data\n    restart: unless-stopped\n    ports:\n      - 3900:3900\n      - 3901:3901\n      - 3902:3902\n      - 3903:3903\n\n  webui:\n    image: khairul169/garage-webui:latest\n    container_name: garage-webui\n    restart: unless-stopped\n    volumes:\n      - ./garage.toml:/etc/garage.toml:ro\n    ports:\n      - 3909:3909\n    environment:\n      API_BASE_URL: \"http://garage:3903\"\n      S3_ENDPOINT_URL: \"http://garage:3900\"\n\n\n### Without Docker\n\nFor a standalone installation, download the latest binary from the [release page](https://github.com/khairul169/garage-webui/releases/latest) (target=\"_blank\"). For example, for Linux AMD64:\n\nsh\nwget -O garage-webui https://github.com/khairul169/garage-webui/releases/download/1.1.0/garage-webui-v1.1.0-linux-amd64\nchmod +x garage-webui\nsudo cp garage-webui /usr/local/bin\n\n\nThen, run the program with your `garage.toml` configuration path:\n\nsh\nCONFIG_PATH=./garage.toml garage-webui\n\n\nYou can also set up a systemd service for automatic startup:\n\nsh\nsudo nano /etc/systemd/system/garage-webui.service\n\n\nAdd the following content:\n\n\n[Unit]\nDescription=Garage Web UI\nAfter=network.target\n\n[Service]\nEnvironment=\"PORT=3919\"\nEnvironment=\"CONFIG_PATH=/etc/garage.toml\"\nExecStart=/usr/local/bin/garage-webui\nRestart=always\n\n[Install]\nWantedBy=default.target\n\n\nReload and start the service:\n\nsh\nsudo systemctl daemon-reload\nsudo systemctl enable --now garage-webui\n\n\n## Examples\n\nOnce your Garage Web UI instance is running, you can access it via your web browser at `http://your-ip:3909`. For enhanced security, it is recommended to place it behind a reverse proxy with SSL.\n\nTo enable authentication for the Web UI, set the `AUTH_USER_PASS` environment variable in the format `username:password_hash`. You can generate the password hash using `htpasswd`:\n\nbash\nhtpasswd -nbBC 10 \"YOUR_USERNAME\" \"YOUR_PASSWORD\"\n\n\nThen, update your `docker-compose.yml` or environment variables accordingly:\n\nyml\nwebui:\n  ....\n  environment:\n    AUTH_USER_PASS: \"username:$2y$10$DSTi9o...\"\n\n\n## Why Use It\n\nGarage Web UI offers significant advantages for anyone managing a Garage Object Storage instance:\n\n*   **Simplified Management**: Provides a visual interface for tasks that would otherwise require command-line operations, making administration more accessible.\n*   **Comprehensive Overview**: Get a quick glance at your Garage cluster's health, layout, and resource usage.\n*   **Efficient Operations**: Easily create, modify, and delete buckets, and manage access keys without manual configuration files.\n*   **Self-Hosted Control**: Maintain full control over your storage and its management interface within your own infrastructure.\n*   **Seamless Integration**: Designed to work effortlessly with existing Garage deployments, especially those using Docker.\n\n## Links\n\n*   **GitHub Repository**: [khairul169/garage-webui](https://github.com/khairul169/garage-webui) (target=\"_blank\")\n*   **Garage Object Storage**: [Official Website](https://garagehq.deuxfleurs.fr/) (target=\"_blank\")\n*   **Screenshots**: [View Screenshots](https://github.com/khairul169/garage-webui/blob/main/misc/SCREENSHOTS.md) (target=\"_blank\")","metrics":{"detailViews":7,"githubClicks":5},"dates":{"published":null,"modified":"2025-11-30T16:00:55.000Z"}}