Cachet is a popular open-source status page system that allows you to display the status of your services and communicate with your users during outages. Installing Cachet on an Ubuntu 24.04 server can help you manage and inform your users about system status effectively. This guide will walk you through the installation process on your VPS server. For reliable hosting solutions, consider using windowsvps for your next VPS server deployment.

Prerequisites

Before you begin, ensure that you have the following:

• A VPS server running Ubuntu 24.04.
• Root or sudo access to the server.
• A registered domain name pointing to your server's IP address (optional, but recommended).
• Apache, MySQL, and PHP installed on your server.

Step 1: Update Your System

Start by updating your package list and installed packages:

sudo apt update && sudo apt upgrade -y

Step 2: Install Required Packages

Install the necessary packages for Cachet:

sudo apt install apache2 mysql-server php php-mysql php-xml php-mbstring php-zip php-curl php-gd php-json unzip -y

Step 3: Download Cachet

Navigate to the web directory and download the latest version of Cachet:

cd /var/www/html
wget https://github.com/CachetHQ/Cachet/archive/refs/heads/master.zip

Unzip the downloaded file:

unzip master.zip
mv Cachet-master cachet
rm master.zip

Step 4: Set Up Directory Permissions

Set the ownership of the Cachet directory to the Apache user:

sudo chown -R www-data:www-data /var/www/html/cachet

Set the correct permissions:

sudo chmod -R 755 /var/www/html/cachet

Step 5: Configure MySQL Database for Cachet

Log in to the MySQL shell:

sudo mysql -u root -p

Create a database and user for Cachet:

CREATE DATABASE cachet;
CREATE USER 'cachetuser'@'localhost' IDENTIFIED BY 'your_password';
GRANT ALL PRIVILEGES ON cachet.* TO 'cachetuser'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Step 6: Configure Cachet

Copy the sample environment file:

cp /var/www/html/cachet/.env.example /var/www/html/cachet/.env

Edit the .env file:

nano /var/www/html/cachet/.env

Update the database connection details:

DB_DATABASE=cachet
DB_USERNAME=cachetuser
DB_PASSWORD=your_password

Step 7: Install Composer

Install Composer, a PHP dependency manager, to manage Cachet's dependencies:

sudo apt install composer -y

Step 8: Install Cachet Dependencies

Navigate to the Cachet directory and install the dependencies:

cd /var/www/html/cachet
composer install --no-dev

Step 9: Set Up Apache for Cachet

Create a new Apache configuration file for Cachet:

sudo nano /etc/apache2/sites-available/cachet.conf

Add the following configuration:

<VirtualHost *:80>
    ServerName yourdomain.com
    DocumentRoot /var/www/html/cachet/public

    <Directory /var/www/html/cachet/public>
        AllowOverride All
        Require all granted
    </Directory>

    ErrorLog ${APACHE_LOG_DIR}/cachet-error.log
    CustomLog ${APACHE_LOG_DIR}/cachet-access.log combined
</VirtualHost>

Replace yourdomain.com with your actual domain name.

Step 10: Enable the Cachet Site

Enable the new site and rewrite module:

sudo a2ensite cachet.conf
sudo a2enmod rewrite

Then restart Apache:

sudo systemctl restart apache2

Step 11: Complete the Installation via Web Interface

Open your web browser and navigate to http://yourdomain.com. You should see the Cachet setup page. Follow the prompts to complete the installation.

Conclusion

By following these steps, you have successfully installed Cachet Status Page on your Debian 12 VPS server. This powerful tool allows you to manage and communicate service statuses effectively. For optimal performance and reliable hosting, consider utilizing windowsvps for your next VPS server hosting solution.