Deployment

Locally via Docker

./bin/rails credentials:edit
docker build -t rootstock .
docker run -d -p 80:80 -e RAILS_MASTER_KEY=`cat config/master.key` -e DATABASE_URL="postgres://your-username@host.docker.internal:5432/rootstock_development" --name rootstock rootstock

Because Rootstock runs on Docker, this basically means you can run the app in any configuration you want. See the Procfile for the services you'll need to run.

Self-hosted PaaS

Rootstock can be run easily via Dokku, so you only need to git push to see the latest upgrades in your Rhizome environments. Below are the commands to setup a hypothetical staging environment:

From your Dokku Host

dokku apps:create staging
sudo dokku plugin:install https://github.com/dokku/dokku-postgres.git
dokku postgres:create railsdatabase
dokku postgres:link railsdatabase staging
vi .ssh/id_rsa.pub # input your public key
chmod 400 .ssh/id_rsa.pub
dokku ssh-keys:add default .ssh/id_rsa.pub
dokku config:set staging RAILS_MASTER_KEY=xxx
dokku nginx:set staging client-max-body-size 25m

If it's already running you may need to run dokku proxy:build-config staging

From your Local Machine

git remote add dokku dokku@your-domain.com:staging
git push dokku main
# then, back on the host
dokku ps:scale staging jobs=1

Note that Rootstock is limited to a single job process and more complicated workloads might require customization for horizontal scaling.

SSL

If you'd like to configure SSL via Let's Encrypt (back on the Dokku host) you can run:

dokku apps:create staging
dokku plugin:install https://github.com/dokku/dokku-letsencrypt.git
dokku domains:report staging
# replace random packer URL with the one shown from domains:report, if any
dokku domains:remove staging staging.packer-6481b5fa-f32f-c6ab-b44d-a2621ac2dcee staging.your-domain.com
dokku domains:add staging staging.your-domain.com
dokku domains:report staging
dokku domains:set-global staging.your-domain.com
dokku letsencrypt:set staging email support@your-domain.com
dokku letsencrypt:enable staging