Files
docker-swarm-termina/releases
Claude 97790045ff Add GitHub Actions for automated release builds and deployment tools
- Created GitHub Actions workflow for automated release packaging
  - Triggers on git tags (v*) or manual workflow dispatch
  - Builds uncompressed .tar files for CapRover (as required)
  - Creates checksums and deployment instructions
  - Automatically publishes to GitHub Releases

- Added release build script (create-caprover-releases.sh)
  - Generates backend-caprover-{version}.tar (uncompressed)
  - Generates frontend-caprover-{version}.tar (uncompressed)
  - Creates documentation package (compressed for convenience)
  - Generates SHA256 checksums for verification

- Created QUICKSTART.md for rapid deployment guide
  - Option 1: Pre-built releases (fastest)
  - Option 2: Deploy from source (latest changes)
  - Verification steps and troubleshooting

- Updated documentation for CapRover tar format
  - CapRover requires uncompressed .tar files (not .tar.gz)
  - Updated all references in README, QUICKSTART, and releases/README
  - Added clear notes about file format requirements

- Updated .gitignore to exclude release artifacts but keep README

- Updated main README with CapRover deployment section

This enables automated release creation on tag push and provides
easy deployment packages for CapRover users.

https://claude.ai/code/session_01NfGGGQ9Zn6ue7PRZpAoB2N
2026-01-30 19:14:52 +00:00
..

CapRover Release Packages

This directory contains pre-built deployment packages for CapRover.

Files

Each release includes:

  • backend-caprover-{version}.tar - Backend Flask application (uncompressed for CapRover)
  • frontend-caprover-{version}.tar - Frontend Next.js application (uncompressed for CapRover)
  • documentation-{version}.tar.gz - Deployment documentation (compressed)
  • checksums-{version}.txt - SHA256 checksums for verification

Important: CapRover requires uncompressed .tar files for deployment. The backend and frontend packages are provided as uncompressed tarballs.

Deployment

Option 1: Upload via CapRover Dashboard

  1. Log into your CapRover dashboard
  2. Navigate to your app
  3. Click "Deploy via tarball"
  4. Upload the corresponding .tar file (not .tar.gz - CapRover requires uncompressed tar)
  5. Wait for deployment to complete

Option 2: Use CapRover CLI

# Extract the tar file
mkdir backend-temp
tar -xf backend-caprover-{version}.tar -C backend-temp
cd backend-temp

# Deploy using CLI
caprover deploy

# Clean up
cd ..
rm -rf backend-temp

Option 3: Deploy from Source

For the latest changes, deploy directly from source:

# Backend
cd backend
caprover deploy

# Frontend
cd frontend
caprover deploy

Verification

Verify package integrity using checksums:

sha256sum -c checksums-{version}.txt

Build Your Own

To build release packages from source:

./create-caprover-releases.sh

This will create new packages in this directory.

See Also