This repository packages Basecamp's Fizzy for Cloudron and now targets the Cloudron 9.1 community app flow.
CloudronManifest.jsondefines the package metadata Cloudron reads.CloudronVersions.jsonis the release index for installable community-package versions.Dockerfile.cloudronbuilds the Cloudron-specific container image.cloudron/start.shadapts the Cloudron runtime environment and boots the Rails app.
Cloudron recommends keeping package metadata in a dedicated public repository. This package stays in the application repo for now, but follows the same metadata model.
The primary supported path is the Cloudron 9.1 community app flow.
In the Cloudron dashboard, open Community apps and enter:
https://raw.githubusercontent.com/patattzel/fizzy-cloudron/refs/heads/main/CloudronVersions.json
Cloudron reads the package metadata from that public CloudronVersions.json URL and offers updates automatically.
For manual fallback installs, you can still install the stable package image directly:
cloudron install --image ghcr.io/patattzel/fizzy-cloudron:stable --location fizzyUse stable or an explicit package version such as ghcr.io/patattzel/fizzy-cloudron:1.2.5. Do not use latest.
- Update
CloudronManifest.jsonand bump the packageversion. - Add a matching immutable entry in
CloudronVersions.json. - Push the commit to
main. - Push a matching Git tag in the form
v<version>to publish the immutable Cloudron image tag and refreshstable.
The fork’s OSS CI validates the Rails app, while .github/workflows/publish-image.yml validates and publishes the Cloudron package image from Dockerfile.cloudron.
- Cloudron provides MySQL, local storage, and sendmail through add-ons.
- Persistent application data lives under
/app/data. cloudron/start.shmaps Cloudron environment variables into the settings Fizzy expects.- Secrets such as
SECRET_KEY_BASEand VAPID keys are generated under/app/dataon first boot when not provided.
See the Cloudron guide for installation details, runtime behavior, and release maintenance.