Community Contribution: Production-Ready One-Click Installer for Self-Hosting

[webvijayi]

Summary

I've created a production-ready, one-click self-hosting installer for Cap.so that simplifies deployment and handles edge cases. Would the Cap.so team be interested in linking this from the official documentation?

Repository

https://github.com/webvijayi/cap-install

Installation

# One-liner install
curl -fsSL https://raw.githubusercontent.com/webvijayi/cap-install/main/cap-install.sh | sudo bash

Features

🚀 One-Click Deployment

• Single command installation
• Automatic Docker setup
• MySQL 9 + MinIO + Nginx configuration
• Helper scripts for management

🛡️ Production-Safe

• Never breaks existing websites
• Detects Apache/Nginx conflicts
• Offers alternative ports (8080) when conflicts detected
• Auto-configures reverse proxy integration
• Requires explicit confirmation for destructive actions

🔧 Dual-Mode Support

• Full Install (root): System-wide at /opt/cap, ports 80/443
• User Mode (no root): User directory ~/cap, ports 8080/8443

🌍 Universal Compatibility

• Ubuntu 20.04+, Debian 10+, CentOS 8+, Rocky Linux 8+, Fedora
• Comprehensive exception handling (14+ scenarios)
• Apache/Nginx conflict detection
• MySQL 9 compatibility
• MinIO S3 storage auto-configured

📚 Complete Documentation

• README with installation modes
• FAQ with common questions
• Quick start guide
• Troubleshooting section

Production Safety Example

Scenario: Server running Apache with multiple websites

Installer detects: Apache on port 80
Options offered:
  1) Run Cap on port 8080 ✓ SAFE - Websites keep running
  2) Auto-configure Apache reverse proxy (creates vhost config)
  3) Stop Apache (requires typing "YES I UNDERSTAND")

Default: Non-destructive option keeps everything running

Testing Results

✅ Test 1: Fresh server - All services healthy
✅ Test 2: Nginx conflict - System Nginx untouched, Cap on port 8080
✅ Test 3: User mode - Non-root installation successful

Benefits for Cap.so Users

1. Reduces installation time from hours to minutes
2. Handles complex Docker configuration automatically
3. Production-safe - won't break existing infrastructure
4. Comprehensive error handling for common issues
5. Helper scripts for easy management
6. Well-documented with FAQ and troubleshooting

Request

Would the Cap.so team consider:

1. Linking this installer from the official self-hosting documentation?
2. Adding it to the installation guides as an alternative to manual setup?
3. Reviewing the code for any improvements or suggestions?

I'm happy to:

• Make any changes suggested by the team
• Add official Cap.so branding if desired
• Maintain and update as Cap evolves
• Provide support via GitHub issues

Demo Installation

The installer can be tested on any fresh VPS:

# Test on Ubuntu VPS
curl -fsSL https://raw.githubusercontent.com/webvijayi/cap-install/main/cap-install.sh | sudo bash

# Press Enter 3 times for defaults
# Cap will be running on http://YOUR_IP within 3-5 minutes

Community Feedback Welcome

I created this to make Cap.so self-hosting accessible to more users. Any feedback from the Cap.so team or community would be greatly appreciated!

---

Repository: https://github.com/webvijayi/cap-install
License: MIT
Maintained: Active

[linear]

CAP-547