Easy!Appointments: Self-Hosted Appointment Scheduler

What is Easy!Appointments?

Easy!Appointments is a self-hosted, open-source appointment scheduling system written in PHP with a MySQL database backend. A business runs its own booking page where customers pick a service, a provider, and an open time slot, while staff manage working hours, booking rules, and calendar sync from an admin panel. The GPL-3.0 license means the code is free to install, modify, and run for personal or business use.

Core Scheduling Features

• ✓Appointment and customer management tracked together in one system, per the README's feature list.
• ✓Service and provider organization — configure which providers offer which services.
• ✓Working plans and booking rules control staff availability and which slots can be booked.
• ✓Google Calendar synchronization keeps provider calendars aligned with bookings made through the app.
• ✓A built-in email notification system alerts customers and providers about appointment activity.
• ✓Multi-language interface for the admin and customer-facing pages.
• ✓Runs entirely self-hosted on your own Apache or Nginx server rather than a vendor's cloud.
• ✓Built on PHP with the CodeIgniter framework and tagged rest-api on GitHub, though the README doesn't spell out the API endpoints in detail.

Setting Up Easy!Appointments

For local development, the README has you clone the repo, run `docker compose up`, then open a second terminal into the app container to run `npm install && composer install`, `npm start` for a dev asset watcher, or `npm run build` for production assets — this works on Linux, macOS, and Windows with WSL recommended. For a production server, you'll need Apache or Nginx as the web server, PHP 8.2 or newer, and a MySQL database: set up the database, move the easyappointments folder onto your host, grant write access to the storage directory, then rename the config-sample.php file to config.php, fill in your configuration values, and finish through the setup wizard in your browser.

Other Appointment Schedulers

Common Questions

The problem it solves

A business that wants online appointment booking usually has to hand customer contact details and calendar data to a hosted SaaS scheduler, or build booking logic from scratch. Easy!Appointments' README frames its reason for existing around that gap: an open-source system a business runs on its own server and database, so booking records stay on infrastructure it controls, while still getting the working-hours rules, provider assignment, and Google Calendar sync a scheduler needs.

Best use cases

• •A small clinic, salon, or consultancy that wants an online booking page tied to specific providers and services without sending client data to a third-party SaaS.
• •A developer comfortable running a PHP and MySQL stack who wants to customize booking rules or the admin UI instead of working within a SaaS scheduler's fixed feature set.
• •A business already syncing staff schedules to Google Calendar that wants new bookings to show up there automatically.
• •A team that wants to try the app locally first — the Docker Compose dev setup lets you spin it up without touching a production server.

Who should try it — and who should skip

Try Easy!Appointments if you run a small business or team that needs online appointment booking and would rather host the database yourself than trust a SaaS vendor with client contact details, and if someone on your team can maintain a PHP 8.2+/MySQL server. Skip it if you don't want server upkeep at all — the same company's premium tier, or a hosted product like Calendly, removes that burden but moves your data off your own infrastructure.

Related repositories