feat: Update TCP port from 9999 to 8099 across configuration, documentation, and Docker setup

Author: novnc

Dockerfile

@@ -45,15 +45,15 @@ RUN mkdir -p pastes logs && \
 USER nclip
 
 # Expose ports
-EXPOSE 8080 9999
+EXPOSE 8080 8099
 
 # Health check
 HEALTHCHECK --interval=30s --timeout=10s --start-period=5s --retries=3 \
     CMD curl -f http://localhost:8080/health || exit 1
 
 # Default configuration
 ENV NCLIP_HTTP_PORT=8080 \
-    NCLIP_TCP_PORT=9999 \
+    NCLIP_TCP_PORT=8099 \
     NCLIP_LOG_LEVEL=info \
     NCLIP_STORAGE_TYPE=filesystem \
     NCLIP_OUTPUT_DIR=/app/pastes

Makefile

@@ -109,7 +109,7 @@ docker-build: ## Build Docker image
 
 docker-run: docker-build ## Build and run Docker container
 	@echo "🐳 Running Docker container..."
-	docker run --rm -p 8080:8080 -p 9999:9999 nclip:latest
+	docker run --rm -p 8080:8080 -p 8099:8099 nclip:latest
 
 # Release preparation
 release-check: clean check build-all ## Run all checks for release
@@ -129,7 +129,7 @@ docker-build:
 	docker build -t nclip:$(VERSION) .
 
 docker-run:
-	docker run -p 9999:9999 -p 8080:8080 -v $(PWD)/data:/data nclip:$(VERSION)
+	docker run -p 8099:8099 -p 8080:8080 -v $(PWD)/data:/data nclip:$(VERSION)
 
 # Development setup
 dev-setup:

README.md

@@ -11,7 +11,7 @@ A modern, high-performance netcat-to-clipboard service written in Go, inspired b
 ## Overview
 
 nclip is a dual-input clipboard service that accepts content via:
-- **netcat (nc)** - Traditional command-line input: `echo "text" | nc localhost 9999`
+- **netcat (nc)** - Traditional command-line input: `echo "text" | nc localhost 8099`
 - **HTTP/curl** - Modern web API: `echo "text" | curl -d @- http://localhost:8080`
 - **HTTP/curl** - Web API with multilines support: `ps | curl --data-binary @- http://localhost:8080`
 - **Web UI** - Browser interface at `http://localhost:8080`
@@ -47,7 +47,7 @@ go build -o nclip .
 ./nclip
 
 # Using netcat (traditional)
-echo "Hello World!" | nc localhost 9999
+echo "Hello World!" | nc localhost 8099
 
 # Using curl (modern)
 echo "Hello World!" | curl -d @- http://localhost:8080
@@ -61,10 +61,10 @@ open http://localhost:8080
 ### Command Line
 ```bash
 # Share a file via netcat
-cat myfile.txt | nc localhost 9999
+cat myfile.txt | nc localhost 8099
 
 # Share command output
-ls -la | nc localhost 9999
+ls -la | nc localhost 8099
 
 # Share via HTTP with curl
 echo "Secret message" | curl -d @- http://localhost:8080
@@ -76,7 +76,7 @@ curl -d @myfile.txt http://localhost:8080
 ### Configuration
 ```bash
 # Custom ports and domain
-./nclip -domain paste.example.com -tcp-port 9999 -http-port 8080
+./nclip -domain paste.example.com -tcp-port 8099 -http-port 8080
 
 # Use MongoDB storage
 ./nclip -storage-type mongodb -mongodb-uri mongodb://localhost:27017
@@ -102,7 +102,7 @@ cd nclip
 docker-compose up -d
 
 # Access the service
-echo "Hello Docker!" | nc localhost 9999
+echo "Hello Docker!" | nc localhost 8099
 ```
 
 ### Kubernetes

docker-compose.yml

@@ -39,15 +39,15 @@ services:
       # Application Configuration
       NCLIP_URL: http://localhost:8080
       NCLIP_HTTP_PORT: 8080
-      NCLIP_TCP_PORT: 9999
-      NCLIP_EXPIRE_DAYS: 30
-      NCLIP_LOG_LEVEL: info
-      NCLIP_ENABLE_METRICS: "true"
-      NCLIP_ENABLE_WEBUI: "true"
-      NCLIP_RATE_LIMIT: "20/min"
+  NCLIP_TCP_PORT: 8099
+  NCLIP_EXPIRE_DAYS: 30
+  NCLIP_LOG_LEVEL: info
+  NCLIP_ENABLE_METRICS: "true"
+  NCLIP_ENABLE_WEBUI: "true"
+  NCLIP_RATE_LIMIT: "20/min"
     ports:
       - "8080:8080"   # HTTP interface
-      - "9999:9999"   # TCP netcat interface
+      - "8099:8099"   # TCP netcat interface
     depends_on:
       mongodb:
         condition: service_healthy

docs/DOCKER_KUBERNETES_DEPLOYMENT.md

@@ -35,7 +35,7 @@ services:
     build: .
     ports:
       - "8080:8080"
-      - "9999:9999"
+  - "8099:8099"
     environment:
       - NCLIP_STORAGE_TYPE=mongodb
       - NCLIP_MONGODB_URI=mongodb://mongo:27017
@@ -111,7 +111,7 @@ RUN adduser -D -s /bin/sh nclip
 USER nclip
 
 # Expose ports
-EXPOSE 8080 9999
+EXPOSE 8080 8099
 
 # Run the application
 CMD ["./nclip"]
@@ -246,7 +246,7 @@ spec:
         image: your-registry/nclip:latest
         ports:
         - containerPort: 8080
-        - containerPort: 9999
+        - containerPort: 8099
         env:
         - name: NCLIP_STORAGE_TYPE
           value: "mongodb"
@@ -296,8 +296,8 @@ spec:
     port: 80
     targetPort: 8080
   - name: tcp
-    port: 9999
-    targetPort: 9999
+    port: 8099
+    targetPort: 8099
   type: LoadBalancer
 
 ---

docs/DOCKER_KUBERNETES_STORAGE_GUIDE.md

@@ -42,7 +42,7 @@ docker-compose up -d
 
 **Access:**
 - Application: http://localhost:8080
-- Netcat: `echo "test" | nc localhost 9999`
+- Netcat: `echo "test" | nc localhost 8099`
 - MongoDB Admin: http://localhost:8081 (admin/admin123)
 
 ### Option 2: Kubernetes (Production)
@@ -79,7 +79,7 @@ docker-compose up --build
 
 # Test
 echo "Hello MongoDB!" | curl -d @- http://localhost:8080
-echo "Hello MongoDB!" | nc localhost 9999
+echo "Hello MongoDB!" | nc localhost 8099
 ```
 
 ### 2. Filesystem (Simple development)

docs/PARAMETER_REFERENCE.md

@@ -16,7 +16,7 @@ nclip supports configuration via:
 | Parameter | Type | Default | Environment Variable | Description |
 |-----------|------|---------|---------------------|-------------|
 | `--url` | string | `http://localhost:8080/` | `NCLIP_URL` | Base URL template for generated paste URLs |
-| `--tcp-port` | int | `9999` | `NCLIP_TCP_PORT` | TCP port for netcat connections |
+| `--tcp-port` | int | `8099` | `NCLIP_TCP_PORT` | TCP port for netcat connections |
 | `--http-port` | int | `8080` | `NCLIP_HTTP_PORT` | HTTP port for web interface |
 
 ### **Storage Configuration**
@@ -155,7 +155,7 @@ All parameters can be set via environment variables with the `NCLIP_` prefix:
 # Server configuration
 export NCLIP_URL=https://paste.example.com/clips/
 export NCLIP_HTTP_PORT=8080
-export NCLIP_TCP_PORT=9999
+export NCLIP_TCP_PORT=8099
 
 # Storage configuration
 export NCLIP_STORAGE_TYPE=mongodb
@@ -273,7 +273,7 @@ export AWS_SECRET_ACCESS_KEY=...
 ### **Minimal Start**
 ```bash
 ./nclip
-# Starts on localhost:8080 (HTTP) and localhost:9999 (TCP)
+# Starts on localhost:8080 (HTTP) and localhost:8099 (TCP)
 # Returns URLs like: http://localhost:8080/abc12345
 ```
 
@@ -300,7 +300,7 @@ export AWS_SECRET_ACCESS_KEY=...
 | Setting | Default Value | Purpose |
 |---------|---------------|---------|
 | **Base URL** | `http://localhost:8080/` | Local development with HTTP |
-| **Ports** | `8080` (HTTP), `9999` (TCP) | Standard non-privileged ports |
+| **Ports** | `8080` (HTTP), `8099` (TCP) | Standard non-privileged ports |
 | **Storage** | `filesystem` | No dependencies |
 | **Expiration** | `1 day` | Serverless-friendly |
 | **Rate Limit** | `10/min` | Conservative rate limiting |

internal/config/config.go

@@ -48,7 +48,7 @@ func DefaultConfig() *Config {
 	return &Config{
 		// Server defaults
 		BaseURL:           "http://localhost:8080/",
-		TCPPort:           9999,
+		TCPPort:           8099,
 		HTTPPort:          8080,
 		StorageType:       "filesystem",
 		OutputDir:         "./pastes",
@@ -112,7 +112,7 @@ func LoadFromFlags() (*Config, error) {
 		fmt.Fprintf(os.Stderr, "  # Start with default settings\n")
 		fmt.Fprintf(os.Stderr, "  %s\n\n", os.Args[0])
 		fmt.Fprintf(os.Stderr, "  # Custom URL and ports\n")
-		fmt.Fprintf(os.Stderr, "  %s -url https://paste.example.com/clips/ -tcp-port 9999 -http-port 8080\n\n", os.Args[0])
+		fmt.Fprintf(os.Stderr, "  %s -url https://paste.example.com/clips/ -tcp-port 8099 -http-port 8080\n\n", os.Args[0])
 		fmt.Fprintf(os.Stderr, "  # With custom storage and directory\n")
 		fmt.Fprintf(os.Stderr, "  %s -url https://paste.example.com/clips/ -storage-type mongodb -mongodb-uri mongodb://localhost:27017\n\n", os.Args[0])
 	}

internal/config/config_test.go

@@ -15,8 +15,8 @@ func TestDefaultConfig(t *testing.T) {
 		t.Errorf("Expected default BaseURL 'http://localhost:8080/', got %s", cfg.BaseURL)
 	}
 
-	if cfg.TCPPort != 9999 {
-		t.Errorf("Expected default TCP port 9999, got %d", cfg.TCPPort)
+	if cfg.TCPPort != 8099 {
+		t.Errorf("Expected default TCP port 8099, got %d", cfg.TCPPort)
 	}
 
 	if cfg.HTTPPort != 8080 {

main_test.go

@@ -176,7 +176,7 @@ func TestLambdaFunctionTimeout(t *testing.T) {
 	}()
 
 	// Set a test Lambda environment
-	_ = os.Setenv("AWS_LAMBDA_RUNTIME_API", "localhost:9999")
+	_ = os.Setenv("AWS_LAMBDA_RUNTIME_API", "localhost:8099")
 
 	// Create a channel to track if Lambda mode would be triggered
 	done := make(chan bool, 1)