Back to all templates
Changedetection.io logo

Changedetection.io

Infrastructure256MB+ RAM

Website change detection and monitoring with notifications

monitoringchange-detectionwebnotificationsalerts

Deploy Changedetection.io in 3 Steps

1

Connect Your VPS

Add your server credentials to Server Compass

2

Select Changedetection.io

Choose from our template library

3

Deploy & Configure

Fill in settings and click Deploy

No Docker knowledge required
Step-by-step deployment guide

Deploy Changedetection.io on a VPS with Server Compass

Use the Changedetection.io template in Server Compass to deploy a self-hosted website change monitoring service on your VPS, then verify the web UI in a browser.

About 10 minutesBrowser verified
1
Step 1

Open the server Apps tab

Select the tutorial-vps VPS, open the Apps tab, and start a new app deployment. Keep sensitive server details hidden before capturing or sharing screenshots.

Server Compass Apps tab before creating a Changedetection.io app
2
Step 2

Choose an app template

Click New App and choose the template deployment path so Server Compass can load the built-in catalog.

Choosing to deploy an app from a Server Compass template
3
Step 3

Search for Changedetection.io

Use the template picker search to find Changedetection.io in the Server Compass template catalog.

Searching for Changedetection.io in the Server Compass template picker
4
Step 4

Select the Changedetection.io template

Choose the Changedetection.io template. Server Compass fills the web service, persistent datastore volume, base URL, and public port.

Changedetection.io template selected in Server Compass
5
Step 5

Review the Changedetection.io settings

Confirm the app name and compose service. In this run, the app was named changedetection-demo and used host port 5000.

Reviewing Changedetection.io project settings and compose service
6
Step 6

Deploy Changedetection.io

Review the generated compose settings, confirm the Changedetection.io web port is available, and click Deploy.

Reviewing Changedetection.io environment variables and port before deployment
7
Step 7

Watch the deployment progress

Keep the deployment modal open while Server Compass uploads the compose file, pulls the Changedetection.io image, starts the container, and verifies the stack.

Server Compass deploying the Changedetection.io template on the VPS
8
Step 8

Confirm Changedetection.io is running

After deployment finishes, return to the Apps tab and confirm the Changedetection.io app is marked Running with its application URL available.

Changedetection.io template running in the Server Compass Apps tab
9
Step 9

Open Changedetection.io in the browser

Open the application URL in a browser. The first-run Changedetection.io page confirms the monitoring service is reachable.

The deployed Changedetection.io web UI loaded in a browser

After Changedetection.io Opens

  • Set a strong password in Changedetection.io settings before exposing the service beyond trusted networks.
  • Use a VPN, IP allowlist, firewall rule, or authenticated reverse proxy for production access.
  • Add your first monitored URL and tune the check interval for how often the page should be polled.
  • Configure notifications for the channels your team uses, such as email, Discord, Slack, or webhooks.
  • Add a Playwright browser sidecar if you need to monitor JavaScript-rendered pages.
  • Keep the Changedetection.io image updated for dependency and security fixes.

Verified Result

The Changedetection.io web interface loaded successfully and displayed the first-run monitoring UI.

Changedetection.io deployment questions

What does the Changedetection.io template deploy?

It deploys the Changedetection.io container with a persistent datastore volume and a public web port.

Which port did the tutorial use?

The tutorial used host port 5000, which maps to the Changedetection.io web UI on container port 5000.

Does the template include a browser sidecar?

No. The built-in template deploys the core Changedetection.io service. Add a browser sidecar separately if you need JavaScript-rendered page checks.

Should this become a blog post?

No. The deployment guide should live on the Changedetection.io template detail page and be linked from the reusable template deployment docs page.

Manual Setup Guide

Set Up Changedetection.io from Terminal

Get your hands dirty: manual Changedetection.io deployment guide for developers.

1

Establish SSH Connection

Connect to your remote server using SSH. Make sure you have your server credentials ready.

terminal
# Log into your server
ssh root@<your-server-ip>

# If using key-based auth
ssh -i ~/.ssh/my-key root@<your-server-ip>

First time? Docker not installed? Run: curl -fsSL https://get.docker.com | sh

2

Create Project Directory

Set up a directory to store your Docker configuration.

terminal
# Create and navigate to project directory
mkdir -p ~/apps/changedetection
cd ~/apps/changedetection
3

Configure Docker Compose

Add this configuration to your docker-compose.yml file:

docker-compose.yml
services:
  changedetection:
    image: dgtlmoon/changedetection.io:latest
    ports:
      - "5000:5000"
    environment:
      - TZ=UTC
      - BASE_URL=http://localhost:5000
    volumes:
      - changedetection_data:/datastore
    restart: unless-stopped

volumes:
  changedetection_data:
Environment Variables
PORTHost port to expose(default: 5000)
4

Start the Services

Execute the deployment and check the container status.

terminal
# Deploy the application
docker compose up -d

# Check container health
docker compose ps

# Monitor logs
docker compose logs -f --tail=100
5

Allow Incoming Connections

Enable network access by updating your firewall rules.

terminal
# Allow the application port through firewall
sudo ufw allow 5000/tcp
sudo ufw reload

# Access your app at:
# http://your-server-ip:5000
Skip the Terminal

Too complicated? Let Server Compass handle it.

Why type commands when you can click? Deploy Changedetection.io the easy way with Server Compass.

  • Intuitive dashboard
  • Deploy in 3 minutes
  • Free SSL included
  • Blue-green deploys
  • Real-time logs
  • Version history
Download Server Compass$29 one-time • Lifetime license

After Deployment

After deploying Changedetection.io with Server Compass, complete these steps to finish setup

1

Open the Changedetection URL in your browser

2

Add websites to monitor

3

Configure notification channels (email, Slack, Discord, etc.)

Need help? Check out our documentation for detailed guides.

Changedetection.io FAQ

Common questions about self-hosting Changedetection.io

How do I deploy Changedetection.io with Server Compass?

Simply download Server Compass, connect to your VPS, and select Changedetection.io from the templates list. Fill in the required configuration and click Deploy. The entire process takes under 3 minutes.

What are the system requirements for Changedetection.io?

Changedetection.io requires a minimum of 256MB RAM. We recommend a VPS with at least 1024MB RAM for optimal performance. Any modern Linux server with Docker support will work.

Can I migrate my existing Changedetection.io data?

Yes! Server Compass provides volume mapping that allows you to import existing data. You can also use standard Changedetection.io backup and restore procedures.

How do I update Changedetection.io to the latest version?

Server Compass makes updates easy. Simply click the Update button in your deployment dashboard, and the latest Changedetection.io image will be pulled and deployed with zero downtime.

Is Changedetection.io free to self-host?

Changedetection.io is open-source software. You only pay for your VPS hosting (typically $5-20/month) and optionally Server Compass ($29 one-time). No subscription fees or per-seat pricing.

Ready to Self-Host Changedetection.io?

Download Server Compass and deploy Changedetection.io to your VPS in under 3 minutes. No Docker expertise required.

Download Server Compass