Deploy to production
Perron can operate in two modes, configured via config.mode. This allows a build to be either a full static site or be integrated pages in a dynamic Rails application.
Full static sites (standalone mode) can be deployed to any build-based platform, like Netlify and statichost.eu.
Integrated sites (integrated mode) work within a typical Rails application and can be deployed to any Rails host like Heroku or using Kamal.
| Mode |
standalone (default) |
integrated |
|---|---|---|
| Use Case | Full static site | Add static pages to a live Rails app |
| Deployment | Build-based platforms (Netlify, S3, statichost.eu, etc.) | Traditional Rails hosts (Heroku, Kamal, etc.) |
| Output |
output/ directory |
public/ directory |
| Asset Handling | Via Perron | Via Asset Pipeline |
When in standalone mode and ready to generate your static site, run:
RAILS_ENV=production bundle install && rails perron:build
This will create static HTML files in the configured output directory (output by default).
View the Library for deploy scripts to various platforms.
On this page