FerryDocs
Guides

Deploy an app with Postgres

Deploy a small notes API that keeps its data in a Postgres datastore.

Edit on GitHub
points tonotes-db:5432DATABASE_URL${{…}} referencenotesyour appnotes-dbPostgres

Ferry runs a Postgres datastore with the name notes-db.

1 / 4

In this guide, you deploy a small notes API that uses . You create the database. Then you give its to the app with a .

The main command

Terminal
ferry up notes -e 'DATABASE_URL=${{datastore.notes-db.connectionString}}' --follow

Before you start

You need a Ferry server that runs, and the ferry with a login to it. See the Quickstart.

The steps

1. Create the databaseOne command, one Postgres datastore.2. Write the appThree files that read DATABASE_URL.3. Deploy with a referenceThe app gets the URL when it starts.4. Run the migrationCreate the table with a one-off job, then try the app.

Your own Dockerfile

A Dockerfile at the root always wins over the detection.

Create the database

One command creates a Postgres datastore and prints its internal URL.

On this page

The main commandBefore you startThe steps