SVI/ProxmoxVE
1
0
Fork 0
mirror of https://github.com/community-scripts/ProxmoxVE.git synced 2026-03-31 06:34:17 -04:00
Code Issues 2.6k Packages Projects Releases 10 Wiki Activity

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

New Issue
Open
opened 2025-11-20 07:07:18 -05:00 by saavagebueno · 0 comments
saavagebueno commented 2025-11-20 07:07:18 -05:00
Owner
Copy Link

Original Pull Request: https://github.com/community-scripts/ProxmoxVE/pull/5337

State: closed
Merged: No

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.

**Original Pull Request:** https://github.com/community-scripts/ProxmoxVE/pull/5337 **State:** closed **Merged:** No --- ## 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.
saavagebueno added the pull-request label 2025-11-20 07:07:18 -05:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
🛑 Failure to comply with the guidelines
breaking change
bug
bug
bugfix
deferred
delete script
dependencies
enhancement
external
feature
github
help wanted
Implemented in VED waiting push to Main
in project pipeline
invalid
investigation
json
maintenance
new script
new script
nice to have
not a script issue
not planned
organization
pull-request
Mirrored from GitHub Pull Request
 question
refactor
rename script
security
update script
website
wontdo
No Label pull-request
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
saavagebueno
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: SVI/ProxmoxVE#5719
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?