Merge pull request #3 from tommerty/copilot/fix-be6e5914-3fcd-41e1-af00-37240fb151e9

Fix Docker port configuration for flexible Coolify deployment

Author: tommerty

.env.example

@@ -1,5 +1,10 @@
 # Environment Configuration for Production
 NODE_ENV=production
+
+# External port configuration (for Docker port mapping)
+# The application runs on port 3000 internally
+# Change this to map to a different external port if needed (e.g., PORT=3009)
+# Example: PORT=3009 maps external port 3009 to internal port 3000
 PORT=3000
 
 # Optional: Add any additional environment variables here

COOLIFY.md

@@ -5,12 +5,18 @@
 ### Build Configuration
 - **Build Command**: `pnpm install && pnpm build`
 - **Start Command**: `pnpm start`
-- **Port**: 3000
+- **Port**: Application runs on port 3000 internally
 - **Docker Build**: Uses the included Dockerfile
 
 ### Environment Variables
 - `NODE_ENV=production`
-- `PORT=3000`
+- `PORT=<external-port>` (e.g., `PORT=3009` to expose on port 3009, maps to internal port 3000)
+
+### Port Configuration
+- **Internal Port**: Always 3000 (application runs on this port inside the container)
+- **External Port**: Configurable via PORT environment variable (defaults to 3000)
+- **Example**: Setting `PORT=3009` maps external port 3009 to internal port 3000
+- **Avoids Conflicts**: If port 3000 is occupied, set PORT to any available port (e.g., 3009, 8080, etc.)
 
 ### Health Check
 - **Path**: `/`
@@ -34,4 +40,7 @@ The included `docker-compose.yml` can be used for local testing or as a referenc
 - This is a React Router application with SSR
 - Uses pnpm as package manager
 - Includes health checks for better reliability
-- Optimized for production deployment
+- Optimized for production deployment
+- Application always runs on port 3000 internally
+- External port mapping is configurable via PORT environment variable
+- Docker health checks use the internal port 3000

DEPLOYMENT.md

@@ -39,16 +39,23 @@ This guide will help you deploy the Stream Deck Icons application to Coolify.
 
 Set the following environment variables in Coolify:
 - `NODE_ENV=production`
-- `PORT=3000`
+- `PORT=<external-port>` (e.g., `PORT=3009` to expose on port 3009)
+
+**Important**: The application runs on port 3000 internally. The PORT variable only configures the external port mapping to avoid conflicts.
 
 ## Step 5: Build Settings
 
 Configure the following in Coolify:
 - **Build Command**: `pnpm install && pnpm build`
 - **Start Command**: `pnpm start`
-- **Port**: 3000
+- **Port**: Set to match your PORT environment variable (e.g., 3009 for external access)
 - **Health Check Path**: `/`
 
+**Port Configuration**:
+- Internal port: Always 3000 (application runs here)
+- External port: Set via PORT environment variable (defaults to 3000)
+- Example: `PORT=3009` maps external port 3009 → internal port 3000
+
 ## Step 6: Deploy
 
 ### Automatic Deployment (Recommended)
@@ -68,8 +75,14 @@ Configure the following in Coolify:
    - Check that Node.js 22 is available
 
 2. **Health check fails**
-   - Verify the application is running on port 3000
+   - Verify the application is running on port 3000 internally
    - Check application logs in Coolify
+   - Ensure PORT environment variable is set for external port mapping only
+
+3. **Port conflicts**
+   - If you get "port already allocated" errors, set PORT to an available port
+   - Example: `PORT=3009` or `PORT=8080` to avoid conflicts
+   - The application will still run on port 3000 internally
 
 3. **GitHub Actions deployment fails**
    - Verify webhook URL and token are correctly set

Dockerfile

@@ -28,7 +28,7 @@ COPY --from=builder /app/package.json ./package.json
 ENV NODE_ENV=production
 ENV PORT=3000
 
-# Expose port
-EXPOSE 3009
+# Expose the port the app runs on
+EXPOSE 3000
 
 CMD ["pnpm", "start"]

README.md

@@ -56,12 +56,12 @@ This project is configured for deployment on [Coolify](https://coolify.io). Foll
 2. **Configure Build Settings**:
    - Build Command: `pnpm install && pnpm build`
    - Start Command: `pnpm start`
-   - Port: 3000
+   - Port: Set to match your PORT environment variable (defaults to 3000)
    - Use the included `docker-compose.yml` or `Dockerfile`
 
 3. **Environment Variables**:
    - `NODE_ENV=production`
-   - `PORT=3000`
+   - `PORT=<your-preferred-port>` (e.g., `PORT=3009` if port 3000 is occupied)
 
 4. **GitHub Actions Deployment**:
    - Add the following secrets to your GitHub repository:
@@ -82,14 +82,21 @@ To build and run using Docker:
 ```bash
 docker build -t streamdeck-icons .
 
-# Run the container
+# Run the container on port 3000 (default)
 docker run -p 3000:3000 streamdeck-icons
+
+# Or run on a custom port to avoid conflicts (e.g., 3009 externally, 3000 internally)
+docker run -p 3009:3000 streamdeck-icons
 ```
 
 Or use Docker Compose:
 
 ```bash
-docker-compose up -d
+# Default configuration (port 3000)
+docker compose up -d
+
+# Custom external port to avoid conflicts
+PORT=3009 docker compose up -d
 ```
 
 The containerized application can be deployed to any platform that supports Docker, including:

docker-compose.yml

@@ -1,15 +1,13 @@
-version: '3.8'
-
 services:
   app:
     build:
       context: .
       dockerfile: Dockerfile
     ports:
-      - "3009:3009"
+      - "${PORT:-3000}:3000"
     environment:
       - NODE_ENV=production
-      - PORT=3009
+      - PORT=3000
     restart: unless-stopped
     healthcheck:
       test: ["CMD", "curl", "-f", "http://localhost:3000/"]