How to Setup a Free PostgreSQL Database on Railway

Written by: Ekom Enyong

Mar 24, 20215 min read

Railway offers a free plan for hosting databases including PostgreSQL, MongoDB, and Redis. When you need to get started quickly with a hosted database for a new project or prototype, Railway is extremely valuable.

If you’ve been using Heroku as your cloud app platform for PostgreSQL, MongoDB, or Redis databases, I highly recommend trying Railway in your next small project instead.

Railway is a Heroku alternative for PostgreSQL databases

If you’re like me, you’ve grown up hearing something like, “If it ain’t broke, then don’t fix it.” So why would someone switch from Heroku to a new or unknown platform? Is something wrong with Heroku? Absolutely not!

Heroku is a fully managed cloud application platform owned by Salesforce. Developers, teams, and large companies use Heroku to deploy, manage, and scale apps. Heroku is not going anywhere anytime soon.

New and seasoned developers alike utilize their free tier to spin up PostgreSQL and other databases. In my own self-taught modern web development journey, I have used Heroku to build small apps and projects for learning and hobby purposes.

All that being said, we still need the answer to, “Why would someone switch from Heroku to Railway?”

Sleeping apps make for delayed wake up times

When you need a hosted PostgreSQL database for your portfolio or hobby developer projects, Heroku is a great go-to tool for this. However, if you are using the Free tier version of their products, your apps will go to sleep if they don’t receive any traffic after 1 hour.

This means that you app will need to “wake up” the next time it is accessed. This causes a delay that can be bothersome or annoying to the person who makes that first request. Though, all requests after that will perform normally.

Heroku does provide an option to upgrade your account to keep your apps from sleeping, but when working on solo or hobby projects, you may not be able to justify this cost.

Resetting credentials

Periodically, Heroku will change the Heroku Postgres credentials. If you have copy and pasted those credentials elsewhere or hardcoded them into your app, it will likely cause issues until you update them.

This can be resolved by visiting the app Settings page in Heroku or running the heroku config command via the CLI to get the new credentials. Though the credentials are rolled for good reason, it can still be something that annoys developers.

How to setup a free PostgreSQL database on Railway

Enter stage left: Railway. Railway has a beautiful interface and a modern feel you’re going to love using. They also have a generous free tier that is perfect for hobby or solo developers.

The next time you are working on a side project or following a tutorial that calls for running up a PostgreSQL database, consider trying Railway instead of Heroku.

Here’s how to setup a free PostgreSQL database using Railway.

1. Sign up for a Railway account

The homepage for Railway

The homepage for Railway.

Direct your browser to and click Login or Get Started to create an account or sign back into your dashboard.

You can use your Github account to sign in or your email address. Railway will send you a magic link to your inbox.

If you sign up with email, you can still connect your Github account for CI/CD purposes.

2. Create a new project and add a PostgreSQL database

When you follow the link from your email or log in, you will presented with an empty dashboard the option to create your first project or read their documentation.

Click on Create First Project to add a new project to your dashboard. Your screen should look a little something like this:

Screenshot of new Railway project options

Options for starting a new project on Railway.

Click on Provision PostgreSQL. Railway will begin spinning up your database. Once you’re done, you will be ready to view credentials and connect your frontend to your database.

3. Access and view your database credentials

Once your project is set up, your screen will show your project dashboard. If you only need the database URL to connect to your PostgreSQL client, you can click on PostgresSQL in the sidebar navigation and then click the Connect tab as shown in the screenshot below.

View PostgreSQL database credentials in your dashboard

Easily copy the database URL from your project dashboard.

You can view full database credentials by navigating to the Variables section of your Project Dashboard and click on PostgreSQL. This will open an accordion showing all of your database credentials.

You can then reveal or copy your credentials by environment, and create your own custom variables as needed.

View full database credentials with Railway

View your full PostgreSQL database credentials.

Visit the Settings section (located on the sidebar navigation) to get and manage other details about your Railway project including a Project ID, environments, API tokens, and integrations.

Try Railway for your next project

With Railway’s Free Plan, you can have up to 3 projects, with limits of 2 plugins and environments per project. You can learn more about Railway’s other pricing plans and features on their website.

Integrating Railway with Next.js applications

For any fellow Next.js and/or Vercel enthusiasts, Railway has a Vercel integration for serverless deployment. You can also check out Railway’s Next.js Prisma starter repository to learn more about integration.

Integrating Railway with everything else

For the rest of you developers, they have a great example repository of Railway starters for various app builds including Blitz.js, Deno, Hasura, Flask, Express, and more.

Check out their website or read their documentation to learn more.