How to Deploy A Laravel Application to Heroku with Database?

Harish Kumar · · 2689 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:

Part #3: Rule objects based custom validation in Laravel

Laravel comes with multiple ways to add custom validation rules to validate form request inputs. I have already explained some of the ways in the following article links:
Harish Kumar

Part #2: How to use Laravel's Validator::extend method for custom validation

Validation is important in any application as it validates a form before performing actions on it. It allows the user to know their input is accurate and confident about the operation (...)
Harish Kumar

Part #1: Closure-based Custom Laravel Validation

While I was working with Laravel, validation using closure came to my mind, and I know it will be helpful to you. This tutorial assists you with all what is the difference between (...)
Harish Kumar

How to use the enumerations(Enums) of PHP 8.1 in Laravel?

The release of PHP 8.1 brings native enumerations to PHP. There is no more requirement for custom solutions in your Laravel projects since the Laravel v8.69 release has you back. (...)
Harish Kumar

Mobile App Development Process

With businesses adopting a mobile-first approach and the growing number of mobile apps, successful mobile app development seems like a quest. But it’s the process that determines (...)
Narola Infotech

What are Laravel Macros and How to Extending Laravel’s Core Classes using Macros with example?

Laravel Macros are a great way of expanding Laravel's core macroable classes and add additional functionality needed for your application. In simple word, Laravel Macro is an (...)
Harish Kumar