How to Deploy A Laravel Application to Heroku with Database?

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

Laravel Pint & VS Code: Automate Your Code Formatting

Laravel Pint is an opinionated PHP code style fixer built on top of PHP-CS-Fixer, designed to simplify the process of ensuring clean and consistent code style in Laravel projects. (...)
Harish Kumar

Laravel Clockwork: A Deep Dive into Debugging, Profiling Skills and Best Practices

In the world of web development, building complex applications often comes with the challenge of identifying and resolving performance bottlenecks. This is where a reliable debugging (...)
Harish Kumar

Effortless PDF Generation in Laravel: A Guide to Using Spatie/Browsershot Package

Looking to generate or export PDF files using Laravel? Look no further! In this article, we'll guide you through using the Laravel spatie/browsershot package to seamlessly convert (...)
Harish Kumar

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