Getting Started with Laravel on Ubuntu

| programming | php | ubuntu |

I’ve really been digging Laravel lately. Especially due to the wonderful documentation and amazing resources provided by Laracasts. Below are some notes on getting going on a local Ubuntu install. I am running Ubuntu 16.10 and these notes assume a fresh install.

Install PHP 7.0 and additional dependencies

sudo apt install php7.0 php7.0-zip php7.0-mbstring phpunit

Install Composer (Globally)

curl -sS https://getcomposer.org/installer | php
sudo mv composer.phar /usr/local/bin/composer

Install the Laravel CLI (Globally)

composer global require "laravel/installer"

Add globally installed composer commands to the PATH

Add the following to the end of your ~/.bashrc file
# Add Composer to the PATH
export PATH=$HOME/.config/composer/vendor/bin:$PATH
You can either source the ~/.bashrc file or open a new terminal window.

Verify everything works

You can do this by running laravel new test_project. Then go to the directory where the new test_project is created with cd test_project. Once you are in the new project directory install all local dependencies with composer install and then run it with php artisan serve. I ran into an issue right away that had to do with the APP_KEY. The error manifested itself as:
The only supported ciphers are AES-128-CBC and AES-256-CBC with the correct key lengths.
A great explanation is shown here but the steps to get a fully functional base install going are:
# Copy the .env.example file to .env
cp .env.example .env


  Generate App Key
  
    
  



php artisan key:generate

Now if you run php artisan serve you will see a fully running Laravel app. Happy Hacking!

Thank you for reading! Share your thoughts with me on bluesky, mastodon, or via email.

Check out some more stuff to read down below.

Most popular posts this month

Recent Favorite Blog Posts

This is a collection of the last 8 posts that I bookmarked.

Articles from blogs I follow around the net

Recently

I skipped August's Recently because this summer has been relentless, mostly in the positive sense. July and August were filled with bike rides, 5K races, friends in town, life changes and logistics.For a friend's birthday, we rode the rickety Coney Island...

via macwright.com September 1, 2026

The Swiss Cheese model, pt. 3

After two more serious posts in this series, I wanted to stop somewhere a bit more lighthearted and inconsequential. “Here’a a fun thing you can try,” begins this 13-minute video from Retro Game Mechanics Explained: The premise of the parlor trick the vide...

via Unsung August 31, 2026

My Experience Has Nuance, Yours Is a Data Point

Eric Bailey has a fun little post about how we need more than a few icons to express the nuance of our shared human experience. For example, he suggests Netflix provide some feedback buttons to indicate the kinds of experiences we all share consuming and r...

via Jim Nielsen’s Blog August 31, 2026

Generated by openring