Changing host and port

Backend

By default, the backend listens on localhost:5050.

To run the server on a different host and port, you need to change the values passed to the --host and --port parameters during startup and also make sure the frontend knows the new values.

Changing the host and port for the backend

Linux

Copy start.sh to start_custom.sh and edit the --host and --port parameters.

#!/bin/sh
uv run src/talemate/server/run.py runserver --host 0.0.0.0 --port 1234

Windows

Copy start.bat to start_custom.bat and edit the --host and --port parameters.

uv run src\talemate\server\run.py runserver --host 0.0.0.0 --port 1234

Letting the frontend know about the new host and port

Copy talemate_frontend/example.env.development.local to talemate_frontend/.env.production.local and edit the VITE_TALEMATE_BACKEND_WEBSOCKET_URL.

VITE_TALEMATE_BACKEND_WEBSOCKET_URL=ws://localhost:1234

Next rebuild the frontend.

cd talemate_frontend
npm run build

Start the backend and frontend

Start the backend and frontend as usual.

Linux

./start_custom.sh

Windows

start_custom.bat

Frontend

By default, the frontend listens on localhost:8080.

To change the frontend host and port, you need to change the values passed to the --frontend-host and --frontend-port parameters during startup.

Changing the host and port for the frontend

Linux

Copy start.sh to start_custom.sh and edit the --frontend-host and --frontend-port parameters.

#!/bin/sh
uv run src/talemate/server/run.py runserver --host 0.0.0.0 --port 5055 \
--frontend-host localhost --frontend-port 8082

Windows

Copy start.bat to start_custom.bat and edit the --frontend-host and --frontend-port parameters.

uv run src\talemate\server\run.py runserver --host 0.0.0.0 --port 5055 --frontend-host localhost --frontend-port 8082

Start the backend and frontend

Start the backend and frontend as usual.

Linux

./start_custom.sh

Windows

start_custom.bat