Cachet is an open-source platform designed for organizations to efficiently create status pages. The cachet is perfect for businesses and organizations of all sizes. It includes essential tools for maintaining and communicating service statuses and ensuring accessibility for administrators and users. When it comes to hosting Cachet, Contabo is preferred due to its scalable infrastructure and seamless deployment options. ServerAvatar makes the deployment of the Cachet Application on the Contabo platform an easy step-by-step process.
Create VM Instance in Contabo
What Is Contabo?
Contabo is a web hosting company that provides a variety of internet hosting services. Founded in Germany in 2003, Contabo offers services such as:
- VPS Hosting: Virtual Private Servers with scalable resources for various needs, from small projects to larger applications.
- Dedicated Servers: Physical servers dedicated to a single user, offering high performance and control.
- Web Hosting: Shared hosting solutions for websites, which include storage, bandwidth, and various management tools.
- Object Storage: Scalable storage solutions for managing large amounts of data.
- Domain Registration: Services for registering and managing domain names.
Contabo is known for its competitive pricing, high-performance hardware, and customer service, making it a popular choice for both individual users and businesses looking for reliable hosting solutions.
To set up a server in Contabo, begin by logging into your Contabo account. Once logged in, proceed with the following steps.
Step 1: Create an account on Contabo
Login to your Contabo account, select "VPS" from the dropdown menu, and then click on "Cloud VPS".
Step 2: Select your Cloud VPS plan
Contabo offers a variety of Cloud VPS options. Here, you should select the plan that best meets your requirements as shown in the below image.
Step 3: Select Region
- First, you need to select the term length (in months) according to your requirements.
- Next, you will need to select the location for your VPS. Contabo offers multiple options for selecting the location.
- It's recommended to select the region closest to your audience. This ensures that your sites load faster for the majority of your audience due to reduced latency.
Step 4: Select your Storage Type
Contabo provides different types of storage space, including both complimentary and paid options. Here, you should select the storage type based on your specific requirements. As shown in the image below.
Step 5: Select an Image or an OS
In this step, you need to select the Operating System for your cloud VPS. The Cachet application generally requires Ubuntu 18.04 LTS or a later version to ensure optimal compatibility and support.
We recommend using Ubuntu 20.04 LTS x64 or Ubuntu 22.04 LTS x64. If you are using ServerAvatar to manage your cloud VPS, these operating systems are recommended.
Step 6: Setting a Password
Here, it's recommended to create a strong password for your root user, as it holds all privileges on the Linux OS.
Step 7: Select Object Storage
Now, you need to select object storage space for backing up your VPS. You will find several options ranging from 250 GB to 1 TB. If you do not require object storage you can select the None option from the dropdown.
Step 8: Select Network
- In the Network section, you will find three options, You should select these according to your specific requirements:
- Private Network
- Bandwidth
- IPv4
Step 9: Selecting Additional Options
- Backup Space: This option allows you to add additional storage space dedicated specifically for backups of your VPS data.
- Server Management: Contabo offers server management services where they handle the day-to-day operations of your VPS.
- Monitoring: This option provides monitoring services for your VPS. It includes monitoring server uptime, resource usage (CPU, RAM, disk), and network connectivity.
- SSL: SSL (Secure Sockets Layer) certificates are crucial for securing communication between your website and its visitors.
After completing all the necessary steps, click on the "Next" button to proceed to the payment method where you can finalize your details.
Step 10: Finalize Details
In this step, you can review all your selections for your Cloud VPS, finalize your details, and proceed with the payment. In a few minutes, your Cloud VPS will be ready. Now, we need to perform the initial configuration to host PHP-based frameworks and software.
Initial Server Configuration
The Initial server configuration includes the installation and configuration of various packages required to host your website. Usually, You have to write commands and modify configuration files. Luckily, With ServerAvatar, Your full server configuration and optimization can be automated.
Here are the three ways to automatically configure your server with ServerAvatar.
Connect a server using a direct method
- Login/Register to ServerAvatar account, click the Create button from the right side of the screen, and select Server from the dropdown.
- Select Direct Method in the serve connecting method section.
- Type the Server Name as per your choice.
- Select a Tech Stack as per your need. You can either select Apache, Nginx, OpenLiteSpeed or Node Stack.
- Select a Database: MySQL, MariaDB or MongoDB.
- Enable the toggle if you want to install the latest LTS version of node.js on your server.
- Select a Management plan and click the Connect Now button.
- You’ll see the command on your screen. Login to your server using an ssh connection and execute that command as a root user.
- The server connection process will be started on your ServerAvatar account after executing the command.
Connect a server using integration
- Login/Register to your ServerAvatar account, navigate to the Integration tab from the sidebar of the panel, and access Cloud Platform from the dropdown.
- Now Select a cloud platform you want to link with ServerAvatar.
- The popup form will appear on your screen. Enter details to link your cloud provider account. The integration method is different based on the cloud provider you select.
- You can integrate five different cloud provider platforms with ServerAvatar, which is-
Check the above link of cloud platforms to know more about integrating cloud platforms with ServeAvatar.
Connect a server using commands
Step 1. Login to your server using root user
Once you create a server as per your requirements, connect to your server using an ssh connection and execute the below three commands as a root user in your server console area.
wget https://srvr.so/install
chmod +x install
./install
Step 2. Select a web server
It will ask you which web server you would like to install on your server: Apache, Nginx, OpenLiteSpeed or Node Stack. Type anyone that you would like to install on your server and hit the enter button.
Step 3. Claim your server
Completing the process will give you a link to claim your server.
Open the link on your browser to access the ServerAvatar server panel.
Install and Setup Cachet status page system with ServerAvatar
Step 1: Create a PHP application
To create an application, go to the ServerAvatar server panel, navigate to the Applications tab, and click the Create button like the following image.
1. Fill in basic detail
In the first step, fill in the basic details, including the Application Name, select the Domain type, and type the Primary Domain/Test Domain Name.
Note that:
If you want to host Joomla CMS on your domain, then make sure to point your domain to the current IP address of your server, and for that:
- Log in to your hosting provider site, where you buy your domain. You can check your domain information with one click.
- Access DNS Manager to edit your DNS records(contact the support team if you don’t find them)
- Change the IP address of A Record of your website to the current server’s IP address.
Note that:
For accessing Cachet on the subdomain, you need to add your subdomain on A Record that points to the current IP address of your server. To point to an IPV6 address, you would need to use an AAAA record
Click the Next Step to continue.
2. Select the application creation method
Here you can fill in the required details. It includes-
- Select the Git method and GitHub as a service provider so we can deploy an application from Git public repository.
- Mark on Public Repository.
- Type/Paste the GitHub project URL. You’ll find the link on GitHub in the image below.
- Type the Branch of the GitHub project.
- Type the below commands in the deployment script.
php7.3 /usr/bin/composer install cp .env.example .env php7.3 artisan key:generate
Note that:
Note that: Cachet supports PHP7.1 To 7.3, we need to specify the version in the command in the deployments script.
3. Allocate system user
System users manage the resources of the application. You can create a new application user or give permission to the existing user.
Click the Next Step to continue.
4. Other Options
In this step, select PHP version 7.3. Cachet supports PHP 7.1 - 7.3. Type Public in the Custom Webroot field.
5. Review your application details
Review your application details. Click the Create Application button.
Step 2: Create a Cachet database
On the server panel, navigate to the Databases tab from the sidebar and click the Create button to create a MySQL database.
Fill in database details, including-
- Database Name
- Database Username
- Database Password
Step 3: Delete the .env.example file and update the database information
To delete the .env.example file, go to the application panel>>file manager and access the public_html folder. Now check the Show Hidden Files. The .env.example file is at the top of the multiple hidden files. Please select the file and delete it like the following image.
Now open the .env file and change the database details we created in the second step. It includes-
DB_DATABASE: Database Name DB_USERNAME: Database Username DB_PASSWORD: Database Password
Don’t forget to save the file(CTRL+s) after making appropriate changes.
Step 4: Install SSL
To install SSL for your application. Go to your application panel and click the SSL Certificate from the sidebar.
You can install Automatic SSL or a Custom installation method to secure your site with an SSL certificate. It is recommended to install automatic SSL for your application.
Step 5: Install and Set up Cachet
1. Environment set up
Access your domain/subdomain on the browser to install and set up Cachet. The setup screen will look like the following image.
Fill in the required details in the above image and click the Next button.
2. Status Page Setup
On the next page, you’ll need to set up the status page. Here you can fill up the details, including your Website Name, Website Domain, Timezone, and Language.
Click the Next button to continue.
3. Administrator Account
Fill up admin details, including** Admin Username**, Email, and Password.
Once you enter all the details, click the Complete Setup button. The message will display like the following image. Click the Go To Dashboard button to continue.
Notice: you may see the error “An error occurs, and this resource cannot be displayed.”
If it occurs, log in to your application using an SSH connection. You can see the credentials in the application panel in the following image.
Execute the following command in your terminal to log in to your application-
ssh Username@Host
Now go to your application path using “cd Application_Name/public_html” and execute the following command.
Php7.3 artisan migrate:refresh
After that, go to your setup page and click the Complete Setup button. It will configure cachet successfully.
Once you access the dashboard, you’ll create and manage components and incidents, including updating incidents with additional information and marking them as resolved when the issue is fixed.
That’s it. Your CacheT instance should be live and you can start working on your status pages. We hope this tutorial was helpful to you. You can also refer to other deployment tutorials given below.