Self-Hosting dotCMS on a VPS: A Complete Production Guide

Deploy Dashdot for VPS Metrics (Optional)

Dashdot shows real-time CPU, memory, storage, and network consumption for your entire VPS — not just Docker containers.

1. Add DNS Record#

---

Add an A record: metrics.dotcms.info → YOUR_STATIC_IP

2. Deploy via Portainer#

---

1. Stacks → Add Stack, name it dashdot
2. Use the official Dashdot Docker Compose:

   version: "3.5"
   services:
     dash:
       image: mauricenino/dashdot:latest
       restart: unless-stopped
       privileged: true
       ports:
         - "3001:3001"
       volumes:
         - /:/mnt/host:ro

3. Map the port to 3001:3001
4. Deploy

3. Add to Caddy#

---

metrics.dotcms.info {
    reverse_proxy localhost:3001
}

Reload Caddy. Open https://metrics.dotcms.info to see your VPS stats.

4. Integrate with Homarr#

---

In Homarr, go to Settings → Integrations → New Integration, select Dashdot, enter https://metrics.dotcms.info, and test the connection.

On your Homarr board, add a "System Health Monitoring" widget, configure it to use the Dashdot integration, and select which metrics to display (CPU, RAM, storage). This gives you live VPS health visible right on your dashboard.