Docker

Docker

Run the development containers of Easy!Appointments with Docker and Docker Compose.

Written by Alex Tselegidis

Last updated 10 hours ago

Run the development containers of Easy!Appointments with Docker and Docker Compose utility. Docker allows you to compose your application in microservices, so that you can easily get started with the local development.

Simply clone the project and run docker compose up to start the environment.

You will need copy config-sample.php modify the root config.php so that it matches the following example:

class Config {
    // ----------------------------------------------------------
    // GENERAL SETTINGS
    // ----------------------------------------------------------

    const BASE_URL      = 'http://localhost'; 
    const LANGUAGE      = 'english';
    const DEBUG_MODE    = TRUE;

    // ----------------------------------------------------------
    // DATABASE SETTINGS
    // ----------------------------------------------------------

    const DB_HOST       = 'mysql';
    const DB_NAME       = 'easyappointments';
    const DB_USERNAME   = 'user';
    const DB_PASSWORD   = 'password';

    // ----------------------------------------------------------
    // GOOGLE CALENDAR SYNC
    // ----------------------------------------------------------

    const GOOGLE_SYNC_FEATURE   = FALSE;
    const GOOGLE_CLIENT_ID      = '';
    const GOOGLE_CLIENT_SECRET  = '';
}

In the host machine the server is accessible from http://localhost and the database from localhost:3306.

You can additionally access phpMyAdmin from http://localhost:8080 (credentials are root / secret) and Mailpit from http://localhost:8025.

Baikal, a self-hosted CalDAV server used to develop the CalDAV syncing integration is available on http://localhost:8100 (credentials are admin / admin).

While activating CalDAV sync with the local Docker-based Baikal, you will need to first create a new Baikal user and then the credentials you defined along with the http://baikal/dav.php URL

Openldap is configured to run through openldap container and ports 389 and 636.

phpLdapAdmin, an admin portal for openldap is available on http://localhost:8200 (credentials are cn=admin,dc=example,dc=org / admin).

Attention: This configuration is meant to make development easier. It is not intended to server as a production environment!

A production image of Easy!Appointments can be found here:

https://github.com/alextselegidis/easyappointments-docker

For more development info check the GitHub documentation files:

https://github.com/alextselegidis/easyappointments/tree/main/docs