saas/README.md
This is a Rails engine that 37signals bundles with Fizzy to offer the hosted version at https://fizzy.do.
To make Fizzy run in SaaS mode, run this in the terminal:
bin/rails saas:enable
To go back to open source mode:
bin/rails saas:disable
Then you can do Fizzy development as usual.
After making changes to this gem, you need to update Fizzy to pick up the changes:
BUNDLE_GEMFILE=Gemfile.saas bundle update --conservative fizzy-saas
The first time, you need to:
stripe login and authorize the environment 37signals DevelopmentThen, for working on the Stripe integration locally, you need to run this script to start the tunneling and set the environment variables:
eval "$(BUNDLE_GEMFILE=Gemfile.saas bundle exec stripe-dev)"
bin/dev # You need to start the dev server in the same terminal session
This will ask for your 1password authorization to read and set the environment variables that Stripe needs.
To test native push notifications (APNs and FCM) locally, start the dev server with the --push flag:
bin/dev --push
This will ask for your 1Password authorization to fetch the push credentials. Note that this loads the production APNs and FCM credentials into your environment.
Fizzy is deployed with Kamal. You'll need to have the 1Password CLI set up in order to access the secrets that are used when deploying. Provided you have that, it should be as simple as bin/kamal deploy to the correct environment.
See the Fizzy handbook for runbooks and more.
This environment uses a FlashBlade bucket for blob storage.
Beta is primarily intended for testing product features. It uses the same production database and Active Storage configuration.
There are 4 beta environments:
Deploy with: bin/kamal deploy -d beta1 (or -d beta2, -d beta3, -d beta4)
Staging is primarily intended for testing infrastructure changes. It uses production-like but separate database and Active Storage configurations.
fizzy-saas is released under the O'Saasy License.