Document canaille url configuration for docker

'canaille' url must point on localhost for containerized dummy client to run on local browser and request canaille container on network
This commit is contained in:
loanR 2023-04-12 16:27:46 +02:00
parent 68ec7b9bf0
commit 5347f62c00

View file

@ -28,11 +28,19 @@ The canaille server has some default users:
Docker environment
~~~~~~~~~~~~~~~~~~
If you want to develop with docker, use:
If you want to develop with docker, your browser needs to be able to reach the `canaille` container. The docker-compose file exposes the right ports, but front requests are from outside the docker network: the `canaille` url that makes sense for docker, points nowhere from your browser. As exposed ports are on `localhost`, you need to tell your computer that `canaille` url means `localhost`.
To do that, you can add the following line to your `/etc/hosts`:
.. code-block:: console
cd demo && docker-compose up
127.0.0.1 canaille
To launch containers, use:
.. code-block:: console
cd demo && docker compose up # or docker-compose
Local environment
~~~~~~~~~~~~~~~~~