backend/.docker/development/HOW-TO-USE.md

how to use docker development?

How to setup?

1. have docker installed
2. create a config.env in /.docker/development. inspire its contents from example.config.env

how to run?

1. while in directory /.docker/development run docker compose up -d 1.1 if running first time in docker, make sure you have no node_modules folder present in /.

not working? try this:

1. while in directory /.docker/development run docker compose down -v
2. remove node_modules directory in / if it exists
3. remove .env and config.json file in / if any of them exist
4. while in directory /.docker/development run docker compose up -d --build

how to stop?

1. while in directory /.docker/development run docker compose down

NOTE: if you want also delete all saved data for a full reset, run docker compose down -v instead

how do I access the terminal for the backend service?

make sure the docker services are running, then run docker attach mw_backend-1. this will appear to show nothing at first, but all new logs will show up, and anything you type in the terminal now affect the backend service.

Warning: doing CTRL+C will shut down the backend service, it will not kick your terminal back to its original shell.

how do I read logs?

1. while in directory /.docker/development run docker compose ps
2. note the name of the service you want to see the logs of
3. while in directory /.docker/development run docker compose logs <NAME>. fill in the name of the service without the brackets.

Exposed ports

• http://localhost:8081 - backend API
• http://localhost:8082 - postgres web UI
• postgres://localhost:5432 - postgres