starred/ProxmoxVE

Fork 0

mirror of https://github.com/community-scripts/ProxmoxVE.git synced 2026-04-25 09:15:59 +03:00

[PR #5337] [CLOSED] Add Garage S3-compatible storage container template #5467

New issue

Closed

opened 2026-02-26 14:34:15 +03:00 by kerem · 0 comments

kerem commented

2026-02-26 14:34:15 +03:00

Owner

📋 Pull Request Information

Original PR: https://github.com/community-scripts/ProxmoxVE/pull/5337
Author: @plarson
Created: 6/20/2025
Status: ❌ Closed

Base: main ← Head: main

📝 Commits (1)

3345b56 Add Garage S3-compatible storage container template

📊 Changes

3 files changed (+234 additions, -0 deletions)

View changed files

➕ ct/garage.sh (+71 -0)
➕ ct/headers/garage (+6 -0)
➕ install/garage-install.sh (+157 -0)

📄 Description

Summary

This PR adds a new container template for Garage, a lightweight, distributed S3-compatible object storage solution perfect for self-hosted environments.

What is Garage?

Garage is an open-source, lightweight alternative to MinIO and AWS S3, designed for self-hosted setups. It provides:

Full S3 API compatibility
Distributed architecture with automatic replication
Lightweight resource requirements
Easy setup and maintenance

Template Features

Base OS: Alpine Linux 3.22 (lightweight and secure)
Default Resources: 2 CPU cores, 2GB RAM, 8GB storage
Networking: All standard Garage ports (3900-3903)
Security: Admin token-based authentication
Optional: Built-in Tailscale support for secure remote access

What's Included

Main Script (ct/garage.sh): Container creation with standard ProxmoxVE patterns
Install Script (install/garage-install.sh): Complete Garage setup and configuration
Header File (ct/headers/garage): ASCII art for the installer UI

Post-Installation

The template automatically:

Creates a single-node Garage cluster
Generates secure admin credentials
Creates an initial S3 bucket named 'data'
Provides ready-to-use AWS CLI configuration examples
Saves all credentials to /root/garage-credentials.txt

Endpoints

S3 API: http://<container-ip>:3900
Admin API: http://<container-ip>:3903
Web Interface: http://<container-ip>:3902

Testing

✅ Successfully tested on Proxmox VE 8.4.1
✅ Garage v1.0.1 installation verified
✅ S3 API compatibility confirmed
✅ Admin interface accessible
✅ Tailscale integration working

This addresses the need for a lightweight, self-hosted S3-compatible storage solution as an alternative to MinIO for users who prefer a more minimalist approach.

_{🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.}

## 📋 Pull Request Information **Original PR:** https://github.com/community-scripts/ProxmoxVE/pull/5337 **Author:** [@plarson](https://github.com/plarson) **Created:** 6/20/2025 **Status:** ❌ Closed **Base:** `main` ← **Head:** `main` --- ### 📝 Commits (1) - [`3345b56`](https://github.com/community-scripts/ProxmoxVE/commit/3345b56bc9eb512ec6abf106432d552bba40acc7) Add Garage S3-compatible storage container template ### 📊 Changes **3 files changed** (+234 additions, -0 deletions) <details> <summary>View changed files</summary> ➕ `ct/garage.sh` (+71 -0) ➕ `ct/headers/garage` (+6 -0) ➕ `install/garage-install.sh` (+157 -0) </details> ### 📄 Description ## Summary This PR adds a new container template for **Garage**, a lightweight, distributed S3-compatible object storage solution perfect for self-hosted environments. ### What is Garage? Garage is an open-source, lightweight alternative to MinIO and AWS S3, designed for self-hosted setups. It provides: - Full S3 API compatibility - Distributed architecture with automatic replication - Lightweight resource requirements - Easy setup and maintenance ### Template Features - **Base OS**: Alpine Linux 3.22 (lightweight and secure) - **Default Resources**: 2 CPU cores, 2GB RAM, 8GB storage - **Networking**: All standard Garage ports (3900-3903) - **Security**: Admin token-based authentication - **Optional**: Built-in Tailscale support for secure remote access ### What's Included 1. **Main Script** (`ct/garage.sh`): Container creation with standard ProxmoxVE patterns 2. **Install Script** (`install/garage-install.sh`): Complete Garage setup and configuration 3. **Header File** (`ct/headers/garage`): ASCII art for the installer UI ### Post-Installation The template automatically: - Creates a single-node Garage cluster - Generates secure admin credentials - Creates an initial S3 bucket named 'data' - Provides ready-to-use AWS CLI configuration examples - Saves all credentials to `/root/garage-credentials.txt` ### Endpoints - **S3 API**: `http://<container-ip>:3900` - **Admin API**: `http://<container-ip>:3903` - **Web Interface**: `http://<container-ip>:3902` ### Testing ✅ Successfully tested on Proxmox VE 8.4.1 ✅ Garage v1.0.1 installation verified ✅ S3 API compatibility confirmed ✅ Admin interface accessible ✅ Tailscale integration working ### Related This addresses the need for a lightweight, self-hosted S3-compatible storage solution as an alternative to MinIO for users who prefer a more minimalist approach. --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>

kerem

2026-02-26 14:34:15 +03:00

closed this issue
added the
pull-request
label

kerem referenced this issue

2026-02-26 14:34:30 +03:00

[PR #5467] [MERGED] [Github Action] Update CHANGELOG.md #5551

No milestone

No project

No assignees

1 participant

Notifications

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference

starred/ProxmoxVE#5467

No description provided.

Rows
Columns