This repository provides a Docker-based runtime for the EventSchedule Laravel application. It packages PHP-FPM, Nginx, MariaDB, and a scheduler worker so that the app can be bootstrapped quickly for local development, testing, or small-scale deployments.

• Multi-service stack: PHP-FPM application container, Nginx web server, MariaDB database, and a dedicated scheduler runner.
• Automated bootstrap: Composer dependencies, frontend assets, and the application key are baked into the image at build time; database migrations run automatically when the containers start.
• Persistent volumes: Shared Docker volumes retain database data and uploaded files between restarts.
• Configurable upstream branch: Build arguments allow pinning to a specific EventSchedule git reference.

• Docker Engine 24.0 or newer
• Docker Compose v2 plugin
• Internet access on the build machine to fetch Composer, npm, and git dependencies

1. Review .env and adjust credentials before first start (the repo ships a working .env for local use):

   # In .env set DB_PASSWORD, APP_URL, and (for production) a fixed APP_KEY.
   # See "Environment Configuration" below.

2. Start the stack:

   docker compose up --build -d

3. Visit http://localhost:8080 to access the application.

The first startup can take several minutes while dependencies are installed and assets are compiled.

Key settings are defined in .env and forwarded into the containers. At a minimum you should set DB_PASSWORD. Additional variables supported by Laravel (e.g., MAIL_ settings) can be added to tailor the runtime.

• APP_URL defaults to http://localhost:8080. Set it to the address users actually reach, otherwise generated links and emails point to localhost.
• APP_KEY is generated into the image when it is built, so it stays stable across container restarts but changes whenever you rebuild the image (logging users out and breaking previously encrypted data). For a key that survives rebuilds, generate one and keep it in .env:

  docker compose run --rm app php artisan key:generate --show

  Uncomment the APP_KEY= line in .env and paste the printed value; it then overrides the built-in key for both the app and scheduler services via env_file.

The Dockerfile clones the upstream EventSchedule repository. You can change the source branch or tag by editing APP_REF in docker-compose.yml or passing --build-arg APP_REF=... to docker compose build.

• Logs: View service logs with docker compose logs -f <service>.
• Migrations: The entrypoint runs php artisan migrate --force on startup. Run additional artisan commands via docker compose exec app php artisan ....
• Database access: Connect to MariaDB on localhost:3306 (when exposed) using credentials defined in .env.
• Updating dependencies: Rebuild the app image (docker compose build app) after modifying Composer or npm dependencies.

See CHANGELOG.md for a history of notable updates.

This repository packages the upstream EventSchedule application, which is subject to its own license. Review the upstream project for licensing details and ensure compliance when deploying.