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

“You hold down Control, Shift, Alt, and click Technical Support. And boom.”

(It’s Halloween Week on Unsung, where we’re sharing scary, spooky, and creepy stories.) Imagine this: It’s 8pm on a rainy Sunday night in the ’90s, and you’re bored, so you boot up the family computer looking for something to do. But you’ve already played...

via Unsung October 24, 2026

City Escape

This last week I did an extended weekend trip with some friends to Nasu in Tochigi Prefecture. Had our fill of dairy products. Cheesecakes, yogurt, and milk. The milk tasted to me more like the milk I’d have in the US, than the more creamy that tends to be...

via Longest Voyage October 24, 2026

Manuel Moreale

Writer, web developer

via Uses This October 24, 2026

Generated by openring