In this tutorial, we'll learn how to install Statping on Ubuntu 24.04 server.
In modern server management, uptime transparency is everything. Whether we’re running a web application, API, or internal service, having a status page is a professional way to communicate performance and outages. Instead of relying on third-party tools, we can self-host our own status page using Statping, a lightweight and open-source status monitoring application.
This guide walks through how to install and configure Statping on an Ubuntu 24.04 server, ensuring we can monitor services efficiently and present status updates automatically.
What Is Statping?
Statping is an open-source status page application written in Go. It monitors services—like websites, APIs, or databases—and automatically updates a beautiful dashboard showing uptime, latency, and incidents.
It’s ideal for developers, DevOps teams, or anyone managing infrastructure who wants full control without depending on cloud-based tools.
Prerequisites
Before we begin, ensure we have the following:
- An Ubuntu 24.04 on dedicated server or KVM VPS.
- Basic Linux Command Line Knowledge.
- A domain name pointing A record to server IP.
How to Install Statping on Ubuntu 24.04 Server
Step 1: Update Our Server
Before starting, always ensure the system is clean and updated.
sudo apt update && sudo apt upgrade -y
This updates all packages and ensures we’re using the latest dependencies compatible with Ubuntu 24.04.
Step 2: Install Dependencies
Statping requires Git and Docker to run smoothly. We’ll install both.
sudo apt install git curl ca-certificates apt-transport-https software-properties-common -y
Then, add Docker’s official GPG key and repository:
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] \
https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" \
| sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
Now, install Docker and Docker Compose:
sudo apt update
sudo apt install docker-ce docker-ce-cli containerd.io docker-compose-plugin -y
Enable and start Docker:
sudo systemctl enable docker
sudo systemctl start docker
Step 3: Clone Statping Repository
We’ll now fetch Statping’s official Docker configuration.
cd /opt
sudo git clone https://github.com/statping-ng/statping-ng.git
cd statping-ng
The folder contains all configuration files required to run Statping inside Docker.
Step 4: Launch Statping
Start the container:
sudo docker compose up -d
Verify if it’s running:
sudo docker ps
Note: the status of statping should show Up 5 seconds (health: starting) wait until it become Up About a minute (healthy)
We should see a running container named statping. Once it’s up, access it in the browser:
http://SERVER_IP:8080
Replace SERVER_IP with our actual public IP address.
Step 5: Set Up Firewall
If UFW (Uncomplicated Firewall) is enabled, we’ll allow HTTP access:
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw reload
This ensures our status page is reachable externally.
Step 6: Configure Nginx Reverse Proxy (Optional)
To serve Statping under a domain (like status.example.com), we’ll configure an Nginx reverse proxy.
Install Nginx:
sudo apt install nginx -y
Create Nginx Reverse Proxy Configuration:
sudo nano /etc/nginx/sites-available/status
Add the following configuration:
server {
listen 80;
server_name status.example.com;
location / {
proxy_pass http://127.0.0.1:8080/;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}
Enable and reload Nginx:
sudo ln -s /etc/nginx/sites-available/status /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl restart nginx
Now our status page is live under http://status.example.com.
Step 7: Enable SSL with Let’s Encrypt (Recommended)
To secure our page with HTTPS, install Certbot:
sudo apt install certbot python3-certbot-nginx -y
Run the SSL setup:
sudo certbot --nginx -d status.example.com
Certbot will automatically configure SSL and redirect HTTP to HTTPS.
Step 8: Access and Customize Dashboard
Open the dashboard in the browser:
https://status.example.com
https://status.example.com/login
Log in using the admin credentials are:
username: admin
password: admin
From here, we can:
- Add services (URLs or endpoints)
- Configure check intervals
- Enable notifications (Slack, Email, Discord)
- Customize branding (logo, theme, favicon)
Step 9: Manage and Update Statping
To view logs:
sudo docker logs -f statping
To stop the service:
sudo docker compose down
To update to the latest version:
cd /opt/statping-ng
sudo git pull
sudo docker compose pull
sudo docker compose up -d
This ensures Statping stays current and secure.
Conclusion
By following these steps, we’ve successfully hosted our own uptime and service status page using Statping on Ubuntu 24.04. This setup provides full control, data privacy, and professional visibility for our services—without depending on third-party monitoring tools.
Statping empowers teams to maintain transparency, monitor uptime efficiently, and keep stakeholders informed. Whether we’re managing internal services or client-facing APIs, having a self-hosted status page is a mark of professionalism and reliability.
