How to Deploy A Laravel Application to Heroku with Database?

Harish Kumar · · 4574 Views

In this post, I'll show you the best way to deploy your current Laravel application from local to Heroku with the Postgres database. It's quick and easy.


  1. Git version control

  2. Register for a Heroku account and install the Heroku toolbelt, a command-line tool for managing Heroku apps.

Create the project

Get your Laravel project ready any way you like. For our tutorial, let's create a fresh Laravel app.

laravel new laravel-heroku
cd laravel-heroku

Add your Procfile

Heroku knows which processes to run for the application based on a configuration file that is Procfile. So, we need to create a Procfile to serve the site from /public.

echo web: heroku-php-apache2 public/ > Procfile

Initialize the git repository:

Let's get it into git.

git init
git add .
git commit -m "Initial commit with Procfile."

Create the Heroku app

After installing the Heroku CLI, you need to login to your Heroku account. You can use the following command to login:

heroku login

Next, to create a new Heroku application that you can push to, use the heroku create command:

heroku create

The output of that command would be something like this:

Creating app... done, ⬢ app-name-here |

Setting environmental variables

By default, Laravel offers the environmental variables in the .env file. We should send the data of .env to the Heroku servers.

You can use the following command to set .env variables to Heroku. 

heroku config:set $(cat .env | sed '/^$/d; /#[[:print:]]*$/d')

Configuring the Database

First, add the Heroku add-on for Postgresql. 

heroku addons:create heroku-postgresql:hobby-dev

you should see an output like this:

Adding heroku-postgresql:hobby-dev on app-name-here... done, v14 (free)
Database has been created and is available
 ! This database is empty. If upgrading, you can transfer
 ! data from another database with pgbackups:restore.
Use `heroku addons:docs heroku-postgresql` to view documentation.

At this point your database should be up and running. you can see your Database URL using the following command.

heroku config
# or
heroku pg:credentials:url

It will give us two values, APP_KEY and DATABASE_URL.

You can grab the database credentials from APP_KEY and add that to the .env file, or copy the DATABASE_URL and open your config >> database.php file

Now, at the top, you need to define:

$DATABASE_URL=parse_url('Your database URL');

Next, you need to modify pgsql database config array like this.

// database.php

'pgsql' => [
            'driver' => 'pgsql',
            'host' => $DATABASE_URL["host"],
            'port' => $DATABASE_URL["port"],
            'database' => ltrim($DATABASE_URL["path"], "/"),
            'username' => $DATABASE_URL["user"],
            'password' => $DATABASE_URL["pass"],
            'charset' => 'utf8',
            'prefix' => '',
            'schema' => 'public',
            'sslmode' => 'require',

Next, don't forget to add DB_CONNECTION to pgsql in the Heroku environmental variables.

heroku config:set DB_CONNECTION=pgsql

Push the changes to Heroku and run migrations.

Commit the changes.

git add .
git commit -m "first laravel deployment to heroku"

Push the changes to the Heroku server.

git push heroku master

Now, run the migrations.

heroku run php artisan migrate

If your app environment is in production then it will ask to run the migration on production and enter yes.

Now, we have successfully deployed Laravel on Heroku and set up a database on Heroku.


Please login or create new account to add your comment.

You may also like:

Compress and Download Files in Laravel Using ZipArchive with Examples

In web development, file compression is essential for optimizing data transfer and storage. Laravel provides tools for creating and downloading compressed files. This guide explores (...)
Harish Kumar

Implementing Multi-Authentication with Guards in Laravel

This guide provides a detailed explanation of how to implement multi-authentication using guards in a Laravel application. This is useful for applications that need to support (...)
Harish Kumar

Building Real-Time Chat Applications with Laravel Reverb and Vue 3

Real-time chat applications are increasingly important for seamless communication and instant connectivity. Laravel Reverb and Vue.js 3 provide developers with the tools to create (...)
Harish Kumar

Laravel Facades: Simplifying Code and Improve Readability

As an integral part of Laravel, a renowned PHP framework, Facades provide a static interface to classes stored in the application's service container. They serve as static proxies (...)
Harish Kumar

What is Laravel’s Service Container and How to Use Dependency Injection in Laravel App

Dependency injection and inversion of control are vital in clean web development. They make writing maintainable, testable code possible. Laravel is a famous PHP framework that (...)
Harish Kumar

Secure Your SPA with Laravel Sanctum: A Step-by-Step Guide

In today's web development landscape, Single Page Applications (SPAs) are increasingly popular. But securing their interaction with backend APIs is crucial. Laravel Sanctum provides (...)
Harish Kumar