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
- An active Forge subscription.
- A VPS assigned with that Forge account that has been provisioned.
.... That is it, Forge handles the rest for you!
Open your server panel on Forge and build a new site.
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.
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
.envfile in the root directory. (Using the Environment tab doesn't do anything fancy except saving you SSH'ing in).
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_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.
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!