Environment Variables

The SeaWise client can be configured using environment variables. Most users don't need to change any of these — the defaults work out of the box.

Available Variables

Variable	Default	Description
SEAWISE_PORT	8082	Port for the client web UI
SEAWISE_BIND_ADDR	0.0.0.0	Bind address for the web UI
SEAWISE_DATA_DIR	/config	Directory for configuration files
SEAWISE_API_URL	https://api.seawise.io	SeaWise API endpoint
SEAWISE_WEB_URL	https://seawise.io	SeaWise dashboard URL
PUID	1000	User ID for file ownership
PGID	1000	Group ID for file ownership

Examples

Change the Web UI Port

docker run -d \
  --name seawise \
  --restart unless-stopped \
  -p 9090:9090 \
  -v seawise-data:/config \
  -e SEAWISE_PORT=9090 \
  ghcr.io/seawise-io/seawise-client:latest

Note: When changing the port, update both the -p mapping and the SEAWISE_PORT variable.

Set File Ownership

If your server uses a different user ID:

docker run -d \
  --name seawise \
  --restart unless-stopped \
  -p 8082:8082 \
  -v seawise-data:/config \
  -e PUID=1001 \
  -e PGID=1001 \
  ghcr.io/seawise-io/seawise-client:latest

Docker Compose Example

services:
  seawise:
    image: ghcr.io/seawise-io/seawise-client:latest
    container_name: seawise
    restart: unless-stopped
    ports:
      - "8082:8082"
    volumes:
      - seawise-data:/config
    environment:
      - PUID=1000
      - PGID=1000