Installing Cachet with Forge

Cachet HQ has made this fantastic status/service public facing page so you can communicate the status of your services with your customers easily. They have a fantastic API as well which allows you to make this process almost automatic.

Let's see how easy it is to install via Forge.

What you Need

.... That is it, Forge handles the rest for you!


Open your server panel on Forge and build a new site.
My Server Panel

While that is installing, you should build a database for Cachet. This is not handled by Forge automatically. Open your SQL editor of choice and build a schema for Cachet to work in. phpMyAdmin can easily create schemas for you, I use MySQL Workbench. Or you can skip this step and use sqlite.

Now that has been provisioned. Let's give it the GitHub repo.

Cachet Install

Note: we do not want to run the migrations yet. We won't have given it any configuration so it'll fail and Forge will try to remove the Git repo.

After it has installed, we have 2 options. Define the configuration via the Environment tab in Forge. Or copy and paste the example .env file and change it to match your needs.

You should be aware that this results in the exact same output. A .env file in the root directory. (Using the Environment tab doesn't do anything fancy except saving you SSH'ing in).


SSH Window Copy across the files, use your favourite editor (vim, nano, etc) to change the configuration set.


Just define the variables you can see from the config file on GitHub as variables. Please note you only need to define APP_ENV, APP_DEBUG and APP_KEY if using SQLite.

Update Deployment Script

Make sure to add in the following command into your deployment script:

php artisan key:generate  

You can remove it after the first deployment if you so wish.


Once the configuration file is in place. Just redeploy the site!

You should find that everything has deployed perfectly and the migrations were successfully executed. (If they were not run, check your Deploy script in forge to ensure php artisan migrate --force is listed). If you are using SQLite, make sure you add touch storage/database.sqlite to your deployment script before the migration or it will fail.

Don't forget

Setup a subdomain for the project just as it matches your Forge installation domain. Run the install script and you'll be enjoying this great service!

Share Comment on Twitter