AWS RDS

Outline uses Postgres as its primary data store. We recommend you use a managed service like RDS to host your database.

Setting up RDS

If you haven’t set up RDS before, follow this Amazon tutorial to get started https://aws.amazon.com/getting-started/tutorials/create-connect-postgresql-db/


Outline doesn't take too much database space, so you should be ok with a db.t3.micro and just 1GB of storage (the tutorial uses 20)

Configuring Outline

Once you’ve provisioned an RDS instance, you will need to update docker.env on your install in the following way:


  1. Update DATABASE_URL, POSTGRES_USER, and POSTGRES_PASSWORD to your new database values.

  2. Comment out the configuration line for PGSSLMODE. (SSL is enabled by default) and save these changes.

  3. Run the following command to migrate your new database

    sudo docker compose run --rm outline yarn db:migrate


  4. To check if things are working, restart your server with:

    sudo docker compose stop

    sudo docker compose up -d