Skip to content

Document configurable development host port #69

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
armandoschianodicola wants to merge 2 commits into
base: master
Choose a base branch
from
Open

Document configurable development host port #69

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
714c140
Document configurable development host port
armandoschianodicola Jul 29, 2026
72c0d44
Document configurable development service ports
armandoschianodicola Jul 30, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 15 additions & 3 deletions docs/development/docker.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,18 @@ 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

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:

Expand Down Expand Up @@ -72,8 +83,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``
Expand Down