Use host port 8269 for new installations

CHANGELOG.md

@@ -12,6 +12,7 @@
 - Added a ZimaOS-specific Compose definition with project metadata, persistent storage defaults, and dashboard icon.
 - Added the canonical container icon URL to the ZimaOS and Unraid templates and installation documentation.
 - Clarified platform-specific PUID and PGID values for general Docker, Docker Desktop, ZimaOS, and Unraid.
+- Changed the recommended host WebUI port to `8269` while retaining internal container port `3000`.
 
 ## 3.0.2
 

README.md

@@ -87,7 +87,7 @@ mkdir -p vboxstock-data
 docker run -d \
   --name vboxstock \
   --restart unless-stopped \
-  -p 3000:3000 \
+  -p 8269:3000 \
   -e TZ=America/New_York \
   -e PUID="$(id -u)" \
   -e PGID="$(id -g)" \
@@ -95,7 +95,7 @@ docker run -d \
   ghcr.io/mfwadejr/vboxstock:latest
 ```
 
-Open `http://YOUR-SERVER-IP:3000`, sign in with the initial credentials above, and change the password when prompted.
+Open `http://YOUR-SERVER-IP:8269`, sign in with the initial credentials above, and change the password when prompted. Port `8269` is the recommended host port; it maps to vBoxStock's internal container port `3000`.
 
 The host path mounted at `/data` is essential. Removing the container is safe when this mount remains intact; running without a persistent mount means the database can be lost when the container is replaced. `PUID` and `PGID` determine which host user and group own the database and backup files. They should match the account that owns the host-side data directory.
 
@@ -139,13 +139,14 @@ ZimaOS settings:
 | --- | --- |
 | Project name | `vboxstock` |
 | Image | `ghcr.io/mfwadejr/vboxstock:latest` |
-| WebUI port | `3000` |
+| WebUI host port | `8269` |
+| Internal container port | `3000` |
 | Container data path | `/data` |
 | ZimaOS host path | `/DATA/AppData/vboxstock` |
 | PUID | `1000` |
 | PGID | `1000` |
 
-After installation, open `http://YOUR-ZIMAOS-IP:3000`. The ZimaOS-specific Compose file supplies the icon automatically through its `x-casaos` metadata.
+After installation, open `http://YOUR-ZIMAOS-IP:8269`. The ZimaOS-specific Compose file supplies the icon automatically through its `x-casaos` metadata.
 
 ## Container icon
 
@@ -164,7 +165,8 @@ Use the included `vboxstock-unraid.xml` template or create a container with thes
 | Setting | Value |
 | --- | --- |
 | Repository | `ghcr.io/mfwadejr/vboxstock:latest` |
-| WebUI port | `3000` |
+| WebUI host port | `8269` |
+| Internal container port | `3000` |
 | Container data path | `/data` |
 | Suggested Unraid host path | `/mnt/user/appdata/vboxstock` |
 | Network mode | `bridge` |
@@ -223,6 +225,7 @@ docker exec -e RESET_ADMIN_PASSWORD=NewPassword123 -it vboxstock node server.mjs
 
 - Image: `ghcr.io/mfwadejr/vboxstock:latest`
 - Application port: `3000/tcp`
+- Recommended host port: `8269/tcp` (mapped to container port `3000`)
 - Persistent volume: `/data`
 - Runtime ownership: configurable with `PUID` and `PGID`; installation examples set platform-appropriate values. The image fallback is `99:100` for Unraid compatibility.
 - Health check: `GET /api/health`

docker-compose.yml

@@ -6,7 +6,7 @@ services:
     container_name: vboxstock
     restart: unless-stopped
     ports:
-      - "3000:3000"
+      - "8269:3000"
     volumes:
       - ./data:/data
     environment:

docker-compose.zimaos.yml

@@ -7,7 +7,7 @@ services:
     restart: unless-stopped
     ports:
       - target: 3000
-        published: "3000"
+        published: "8269"
         protocol: tcp
     volumes:
       - type: bind
@@ -22,7 +22,7 @@ x-casaos:
   id: com.mfwadejr.vboxstock
   main: vboxstock
   index: /
-  port_map: "3000"
+  port_map: "8269"
   scheme: http
   icon: https://raw.githubusercontent.com/mfwadejr/vboxstock/main/public/assets/vboxstock-icon-512.png
   title:

vboxstock-unraid.xml

@@ -4,7 +4,7 @@
   <Network>bridge</Network><Shell>sh</Shell><Privileged>false</Privileged>
   <Support>https://github.com/mfwadejr/vboxstock/issues</Support><Project>https://github.com/mfwadejr/vboxstock</Project><Overview>Self-contained vSeeBox inventory and sales tracker with an embedded SQLite database.</Overview>
   <Category>Tools:</Category><WebUI>http://[IP]:[PORT:3000]/</WebUI><TemplateURL>https://raw.githubusercontent.com/mfwadejr/vboxstock/main/vboxstock-unraid.xml</TemplateURL><Icon>https://raw.githubusercontent.com/mfwadejr/vboxstock/main/public/assets/vboxstock-icon-512.png</Icon>
-  <Config Name="Web UI Port" Target="3000" Default="3000" Mode="tcp" Description="vBoxStock web interface" Type="Port" Display="always" Required="true" Mask="false">3000</Config>
+  <Config Name="Web UI Port" Target="3000" Default="8269" Mode="tcp" Description="Recommended vBoxStock host port; maps to container port 3000" Type="Port" Display="always" Required="true" Mask="false">8269</Config>
   <Config Name="App Data" Target="/data" Default="/mnt/user/appdata/vboxstock" Mode="rw" Description="SQLite database and durable application data" Type="Path" Display="always" Required="true" Mask="false">/mnt/user/appdata/vboxstock</Config>
   <Config Name="User ID" Target="PUID" Default="99" Mode="" Description="Host user ID used to own and write application data. Unraid default is 99 (nobody)." Type="Variable" Display="advanced" Required="true" Mask="false">99</Config>
   <Config Name="Group ID" Target="PGID" Default="100" Mode="" Description="Host group ID used to own and write application data. Unraid default is 100 (users)." Type="Variable" Display="advanced" Required="true" Mask="false">100</Config>