Back to all templates
Easy!Appointments logo

Easy!Appointments

Application256MB+ RAM

Self-hosted appointment scheduling

schedulingappointmentsbooking

Deploy Easy!Appointments in 3 Steps

1

Connect Your VPS

Add your server credentials to Server Compass

2

Select Easy!Appointments

Choose from our template library

3

Deploy & Configure

Fill in settings and click Deploy

No Docker knowledge required
Step-by-step deployment guide

Deploy Easy!Appointments on a VPS with Server Compass

Use the Easy!Appointments template in Server Compass to deploy a self-hosted appointment scheduling system with persistent Easy!Appointments application and MySQL volumes on your VPS, then verify the Easy!Appointments web UI in a browser.

About 7 minutesBrowser verified
1
Step 1

Open the server Apps tab

Select your 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 an Easy!Appointments 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 Easy!Appointments

Use the template picker search to find Easy!Appointments in the Server Compass template catalog.

Searching for Easy!Appointments in the Server Compass template picker
4
Step 4

Select the Easy!Appointments template

Choose the Easy!Appointments template. Server Compass fills the Easy!Appointments image, host port, published server URL, and persistent Easy!Appointments application and MySQL volumes.

Easy!Appointments template selected in Server Compass
5
Step 5

Review the Easy!Appointments settings

Confirm the app name and compose services. In this run, the app was named easyappointments-demo and used host port 8080.

Reviewing Easy!Appointments project settings and compose services
6
Step 6

Deploy Easy!Appointments

Review the generated environment values, confirm the port is available, and click Deploy Now.

Reviewing Easy!Appointments 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 Easy!Appointments image, starts the container, and verifies the stack.

Server Compass deploying the Easy!Appointments template on the VPS
8
Step 8

Confirm Easy!Appointments is running

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

Easy!Appointments template running in the Server Compass Apps tab
9
Step 9

Open Easy!Appointments in the browser

Open the application URL in a browser. The Easy!Appointments web UI confirms the site is reachable.

The deployed Easy!Appointments web UI loaded in a browser

After Easy!Appointments Opens

  • Complete the installation wizard, create the administrator account, and configure services before production use.
  • Configure providers, services, working hours, email, HTTPS, and booking policies before inviting users.
  • Add a domain and HTTPS before exposing the scheduling app to users.
  • Back up the Easy!Appointments and MySQL volumes before relying on the scheduler for production bookings.

Verified Result

The Easy!Appointments web UI loaded successfully in a browser.

Easy!Appointments deployment questions

What does the Easy!Appointments template deploy?

It deploys Easy!Appointments with MySQL plus persistent application and database volumes.

Which port did the tutorial use?

The tutorial used host port 8080, which maps to the Easy!Appointments web server on container port 80.

Why does the guide stop at the first-run web UI?

The tutorial verifies the clean first-run web UI because real library paths, users, metadata providers, and remote access settings depend on the production server.

Should this become a blog post?

No. The deployment guide should live on the Easy!Appointments template detail page and be linked from the reusable template deployment docs page.

Self-Deploy Guide

DIY Easy!Appointments Deployment

Learn how to self-host Easy!Appointments with this hands-on deployment guide.

1

SSH into Your Server

Launch your preferred terminal and connect to your VPS using SSH.

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 Working Directory

Prepare a directory for your application files and configuration.

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

Configure Your Containers

Create the Docker Compose configuration file with these contents:

docker-compose.yml
services:
  easyappointments:
    image: alextselegidis/easyappointments:latest
    ports:
      - "8080:80"
    environment:
      - DB_HOST=db
      - DB_NAME=easyappointments
      - DB_USERNAME=easyappointments
      - DB_PASSWORD=<your-db-password>
      - BASE_URL=<your-base-url>
    volumes:
      - easyappointments_data:/var/www/html
    restart: unless-stopped
    depends_on:
      db:
        condition: service_healthy

  db:
    image: mysql:8.0
    environment:
      - MYSQL_ROOT_PASSWORD=<your-db-root-password>
      - MYSQL_DATABASE=easyappointments
      - MYSQL_USER=easyappointments
      - MYSQL_PASSWORD=<your-db-password>
    volumes:
      - mysql_data:/var/lib/mysql
    restart: unless-stopped
    healthcheck:
      test: ["CMD-SHELL", "mysqladmin ping -h localhost -u root -p$$MYSQL_ROOT_PASSWORD || exit 1"]
      interval: 10s
      timeout: 5s
      retries: 5
      start_period: 30s

volumes:
  easyappointments_data:
  mysql_data:
Setup Variables
PORTHost port(default: 8080)
BASE_URLBase URL
DB_PASSWORDDB password
DB_ROOT_PASSWORDRoot password
4

Deploy with Docker Compose

Launch the application stack using Docker Compose.

terminal
# Deploy the application
docker compose up -d

# Check container health
docker compose ps

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

Open Required Ports

Enable external access by opening the necessary port.

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

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

There's an easier way. Meet Server Compass.

Let Server Compass handle the complexity. Deploy Easy!Appointments with a simple, intuitive interface.

  • 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 Easy!Appointments with Server Compass, complete these steps to finish setup

1

Complete installation wizard

2

Create admin and providers

3

Configure services and working hours

Need help? Check out our documentation for detailed guides.

Easy!Appointments FAQ

Common questions about self-hosting Easy!Appointments

How do I deploy Easy!Appointments with Server Compass?

Simply download Server Compass, connect to your VPS, and select Easy!Appointments 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 Easy!Appointments?

Easy!Appointments 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 Easy!Appointments data?

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

How do I update Easy!Appointments to the latest version?

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

Is Easy!Appointments free to self-host?

Easy!Appointments 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 Easy!Appointments?

Download Server Compass and deploy Easy!Appointments to your VPS in under 3 minutes. No Docker expertise required.

Download Server Compass