Basics

This guide assumes you have a running Flynn cluster and the flynn CLI configured. If not, follow the Installation Guide first.

Deploy an App

Flynn deploys applications via git push. Create a Flynn app in your project directory:

cd my-app/
flynn create my-app

This adds a flynn git remote. Deploy by pushing:

git push flynn master

Flynn detects your language, builds the app using a buildpack, and starts it.

After deployment, your app is available at:

http://my-app.<CLUSTER_DOMAIN>

Open it in your browser or check with curl:

flynn open
# or
curl http://my-app.demo.localflynn.com

Set environment variables for your app:

flynn env set DATABASE_URL=postgres://...
flynn env set SECRET_KEY=mysecret

View current configuration:

flynn env

Unsetting a variable:

flynn env unset SECRET_KEY

Setting env vars triggers a new deployment automatically.

View current process formation:

flynn scale

Scale web processes:

flynn scale web=3

Scale multiple types:

flynn scale web=3 worker=2

View app logs:

flynn log

Follow logs in real time:

flynn log -f

Filter by process type:

flynn log -t web

Execute a command in your app’s environment:

flynn run bash
flynn run python manage.py migrate
flynn run rails console

List running processes:

flynn ps

Kill a specific process:

flynn kill <JOB_ID>

View current routes:

flynn route

Add a custom domain:

flynn route add http my-app.example.com

View deployment history:

flynn release show

Roll back to a previous release:

flynn release rollback

Define process types in a Procfile at the root of your project:

web: node server.js
worker: node worker.js
clock: node scheduler.js

Flynn uses this to determine what processes to run.