From 714c140b404cc1a54be4850b0a571bd60fea8d2c Mon Sep 17 00:00:00 2001 From: armandoschianodicola Date: Wed, 29 Jul 2026 18:18:02 +0200 Subject: [PATCH 1/2] Document configurable development host port --- docs/development/docker.rst | 14 +++++++++++--- 1 file changed, 11 insertions(+), 3 deletions(-) diff --git a/docs/development/docker.rst b/docs/development/docker.rst index 02ed950..3d17475 100644 --- a/docs/development/docker.rst +++ b/docs/development/docker.rst @@ -20,7 +20,14 @@ out the wger server git repo: cd docker/dev cp .env.example .env - echo "WGER_CODEPATH=/my/wger/path" > .env + echo "WGER_CODEPATH=/my/wger/path" >> .env + +The web service is available on host port 8000 by default. If that port is +already in use, set ``WGER_HOST_PORT`` in the same ``.env`` file, for example: + +.. code-block:: bash + + echo "WGER_HOST_PORT=8001" >> .env Start docker watch in the docker folder: @@ -72,8 +79,9 @@ After this you can run the following commands to load the initial data: python3 manage.py runserver 0.0.0.0:8000 -You can now login on http://localhost:8000 with the default administrator user -(afterwards you just need to start the server, no need to bootstrap again): +You can now log in on http://localhost:8000 with the default administrator user, +or use the port configured with ``WGER_HOST_PORT``. Afterwards you just need to +start the server; there is no need to bootstrap again: * username: ``admin`` * password: ``adminadmin`` From 72c0d449074e6def7a734b48759510f7bd10f322 Mon Sep 17 00:00:00 2001 From: armandoschianodicola Date: Thu, 30 Jul 2026 18:06:07 +0200 Subject: [PATCH 2/2] Document configurable development service ports --- docs/development/docker.rst | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/development/docker.rst b/docs/development/docker.rst index 3d17475..377d224 100644 --- a/docs/development/docker.rst +++ b/docs/development/docker.rst @@ -29,6 +29,10 @@ already in use, set ``WGER_HOST_PORT`` in the same ``.env`` file, for example: echo "WGER_HOST_PORT=8001" >> .env +When using the ``dev-postgres`` environment, the PostgreSQL and PowerSync host +ports can be changed in the same way with ``POSTGRES_HOST_PORT`` (default 5432) +and ``POWERSYNC_HOST_PORT`` (default 8080). + Start docker watch in the docker folder: .. code-block:: bash