From 0ff468cdfdc0a4715391f5cf3e9818982aaa3fe7 Mon Sep 17 00:00:00 2001
From: mfwadejr <125498560+mfwadejr@users.noreply.github.com>
Date: Sun, 30 Aug 2026 09:46:24 -0400
Subject: [PATCH] Use host port 8269 for new installations
---
CHANGELOG.md | 1 +
README.md | 13 ++++++++-----
docker-compose.yml | 2 +-
docker-compose.zimaos.yml | 4 ++--
vboxstock-unraid.xml | 2 +-
5 files changed, 13 insertions(+), 9 deletions(-)
diff --git a/CHANGELOG.md b/CHANGELOG.md
index f16af36..55e591c 100644
--- a/CHANGELOG.md
+++ b/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
diff --git a/README.md b/README.md
index 86eee92..6769eb4 100644
--- a/README.md
+++ b/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`
diff --git a/docker-compose.yml b/docker-compose.yml
index 459ac98..c1e2976 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -6,7 +6,7 @@ services:
container_name: vboxstock
restart: unless-stopped
ports:
- - "3000:3000"
+ - "8269:3000"
volumes:
- ./data:/data
environment:
diff --git a/docker-compose.zimaos.yml b/docker-compose.zimaos.yml
index f330718..83ca767 100644
--- a/docker-compose.zimaos.yml
+++ b/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:
diff --git a/vboxstock-unraid.xml b/vboxstock-unraid.xml
index a9245b4..0a4821b 100644
--- a/vboxstock-unraid.xml
+++ b/vboxstock-unraid.xml
@@ -4,7 +4,7 @@
bridgeshfalse
https://github.com/mfwadejr/vboxstock/issueshttps://github.com/mfwadejr/vboxstockSelf-contained vSeeBox inventory and sales tracker with an embedded SQLite database.
Tools:http://[IP]:[PORT:3000]/https://raw.githubusercontent.com/mfwadejr/vboxstock/main/vboxstock-unraid.xmlhttps://raw.githubusercontent.com/mfwadejr/vboxstock/main/public/assets/vboxstock-icon-512.png
- 3000
+ 8269
/mnt/user/appdata/vboxstock
99
100