grocy/.docker/README.md

Docker to aid local development

1. Copy .docker/example.env to .env (in project's root directory), change its contents to reflect your user's UID and GID respectively. This will make try to force container to not create any files as root.

2. Copy .docker/example.docker-compose.override.yml to docker-compose.override.yml in application's root directory. You may alter the HOST port (first one, as they're defined as HOST:CONTAINER) leaving container's port as 80.

3. Run docker-compose up (or start) and wait for fetching, extracting and building process to complete (this will happen only once or every time you'd like to rebuild the image)

4. Open separate terminal (or not, if you used docker-compose start before) and install project's dependencies like this:

   $ .docker/composer.sh install
   

5. Visit http://localhost (or http://localhost:8080 if you have altered HOST's port to 8080 in step 2) to see Grocy ready for your hacking.

6. Every time you need Composer for something use:

   $ .docker/composer.sh [require|update|etc] [other arguments]
   

7. You may also use PHP the same way:

   $ .docker/php.sh -v
   

Enjoy!

BONUS

Would you like to see what happens to the app when launched on PHP 7.4 or 8.1? Edit .docker/apache-php/Dockerfile and change image tag in the first line from php:8.0-apache to php:7.4-apache or php:8.1-apache. Then make docker-compose rebuild the container for you:

$ docker-compose build

And voila! After docker-compose up (or start) check what works and what breaks!