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

The surprise deprecation of GPT-4o for ChatGPT consumers

I've been dipping into the r/ChatGPT subreddit recently to see how people are reacting to the GPT-5 launch, and so far the vibes there are not good. This AMA thread with the OpenAI team is a great illustration of the single biggest complaint: a lot of…

via Simon Willison's Weblog: Entries August 8, 2025

How long does it take to upgrade an eBook?

The older I get, the more comfortable I become with complaining. Not merely moaning on social media, but writing a direct email to the perpetrator of some annoyance. I'd purchased an eBook and was appalled by how crappy the accessibility was. If you …

via Terence Eden’s Blog August 8, 2025

P&B: Alexandra

This is the 102nd edition of People and Blogs, the series where I ask interesting people to talk about themselves and their blogs. Today we have Alexandra and her blog, xandra.cc To follow this series subscribe to the newsletter. A new inte…

via Manuel Moreale August 8, 2025

Generated by openring