Change default ports from 8080/8081 to 9670/9671

Updated all documentation, Dockerfiles, compose files, source code, and test scripts to use 9670 for the HTTP API and 9671 for the gossip protocol instead of the previous defaults (8080/8081). This ensures consistency across the project and avoids conflicts with common default ports.

Author: metaspartan

CLAUDE.md

@@ -14,8 +14,8 @@ zig build -Doptimize=ReleaseFast  # Optimized release build
 ## Running the Server
 
 ```bash
-zig build run -- --port 8080 --data ./data --debug
-zig build run -- --join 192.168.1.10:8081 --id node2  # Join existing cluster
+zig build run -- --port 9670 --data ./data --debug
+zig build run -- --join 192.168.1.10:9671 --id node2  # Join existing cluster
 ```
 
 Key flags: `--port`, `--gossip-port`, `--data`, `--id`, `--join`, `--threads`, `--vnodes`, `--debug`

Dockerfile

@@ -23,6 +23,6 @@ COPY --from=builder /build/zig-out/bin/z4 /app/z4
 
 RUN mkdir /app/data
 VOLUME /app/data
-EXPOSE 8080 8081
+EXPOSE 9670 9671
 
 CMD ["/app/z4", "server"]

README.md

@@ -95,8 +95,8 @@ services:
   z4:
     build: .
     ports:
-      - "8080:8080"   # S3 API
-      - "8081:8081"   # Gossip protocol
+      - "9670:9670"   # S3 API
+      - "9671:9671"   # Gossip protocol
     volumes:
       - ./data:/app/data
     environment:
@@ -138,8 +138,8 @@ Z4 includes a built-in CLI for administration.
 
 | Option | Default | Description |
 |--------|---------|-------------|
-| `--port` | 8080 | HTTP API port |
-| `--gossip-port` | 8081 | Cluster gossip port (UDP) |
+| `--port` | 9670 | HTTP API port |
+| `--gossip-port` | 9671 | Cluster gossip port (UDP) |
 | `--data` | data | Storage directory |
 | `--id` | node1 | Unique node identifier |
 | `--join` | - | Seed node address (host:port) |
@@ -163,8 +163,8 @@ After creating a key via CLI:
 aws configure set aws_access_key_id <YOUR_ACCESS_KEY_ID>
 aws configure set aws_secret_access_key <YOUR_SECRET_KEY>
 
-aws --endpoint-url http://localhost:8080 s3 cp file.txt s3://mybucket/
-aws --endpoint-url http://localhost:8080 s3 ls s3://mybucket/
+aws --endpoint-url http://localhost:9670 s3 cp file.txt s3://mybucket/
+aws --endpoint-url http://localhost:9670 s3 ls s3://mybucket/
 ```
 
 ## Architecture

docker-compose.cluster.yml

@@ -3,13 +3,13 @@ services:
     build: .
     container_name: z4-node1
     ports:
-      - "8080:8080"
-      - "8081:8081"
+      - "9670:9670"
+      - "9671:9671"
     volumes:
       - ./data/node1:/app/data
     environment:
       - Z4_ENCRYPTION_KEY=${Z4_ENCRYPTION_KEY:-}
-    command: ["/app/z4", "server", "--id", "node1", "--port", "8080", "--gossip-port", "8081"]
+    command: ["/app/z4", "server", "--id", "node1", "--port", "9670", "--gossip-port", "9671"]
     networks:
       - z4net
     restart: unless-stopped
@@ -18,13 +18,13 @@ services:
     build: .
     container_name: z4-node2
     ports:
-      - "8082:8080"
-      - "8083:8081"
+      - "8082:9670"
+      - "8083:9671"
     volumes:
       - ./data/node2:/app/data
     environment:
       - Z4_ENCRYPTION_KEY=${Z4_ENCRYPTION_KEY:-}
-    command: ["/app/z4", "server", "--id", "node2", "--port", "8080", "--gossip-port", "8081", "--join", "z4-node1:8081"]
+    command: ["/app/z4", "server", "--id", "node2", "--port", "9670", "--gossip-port", "9671", "--join", "z4-node1:9671"]
     depends_on:
       - z4-node1
     networks:
@@ -35,13 +35,13 @@ services:
     build: .
     container_name: z4-node3
     ports:
-      - "8084:8080"
-      - "8085:8081"
+      - "8084:9670"
+      - "8085:9671"
     volumes:
       - ./data/node3:/app/data
     environment:
       - Z4_ENCRYPTION_KEY=${Z4_ENCRYPTION_KEY:-}
-    command: ["/app/z4", "server", "--id", "node3", "--port", "8080", "--gossip-port", "8081", "--join", "z4-node1:8081"]
+    command: ["/app/z4", "server", "--id", "node3", "--port", "9670", "--gossip-port", "9671", "--join", "z4-node1:9671"]
     depends_on:
       - z4-node1
     networks:

docker-compose.yml

@@ -2,11 +2,11 @@ services:
   z4:
     build: .
     ports:
-      - "8080:8080"
-      - "8081:8081"
+      - "9670:9670"
+      - "9671:9671"
     volumes:
       - ./data:/app/data
     environment:
       - Z4_ENCRYPTION_KEY=${Z4_ENCRYPTION_KEY:-}
-    command: ["/app/z4", "server", "--port", "8080", "--gossip-port", "8081", "--data", "/app/data"]
+    command: ["/app/z4", "server", "--port", "9670", "--gossip-port", "9671", "--data", "/app/data"]
     restart: always

src/constants.zig

@@ -14,8 +14,8 @@ pub const MIN_BUCKET_NAME_LENGTH: usize = 3;
 pub const MAX_REQUEST_LINE_LENGTH: usize = 8192;
 pub const LIST_OBJECTS_MAX_KEYS: usize = 1000;
 
-pub const DEFAULT_HTTP_PORT: u16 = 8080;
-pub const DEFAULT_GOSSIP_PORT: u16 = 8081;
+pub const DEFAULT_HTTP_PORT: u16 = 9670;
+pub const DEFAULT_GOSSIP_PORT: u16 = 9671;
 pub const DEFAULT_DATA_PATH = "data";
 pub const DEFAULT_NODE_ID = "node1";
 pub const DEFAULT_OWNER_ID = "z4-owner";

src/main.zig

@@ -391,8 +391,8 @@ fn printHelp() void {
         \\  help                Show this help message
         \\
         \\SERVER OPTIONS:
-        \\  --port <port>       HTTP port (default: 8080)
-        \\  --gossip-port <port>  Gossip port (default: 8081)
+        \\  --port <port>       HTTP port (default: 9670)
+        \\  --gossip-port <port>  Gossip port (default: 9671)
         \\  --data <path>       Data directory (default: data)
         \\  --id <id>           Node ID (default: node1)
         \\  --join <host:port>  Join existing cluster
@@ -407,7 +407,7 @@ fn printHelp() void {
         \\  --owner             Grant owner access (full control)
         \\
         \\EXAMPLES:
-        \\  z4 server --port 8080 --data ./data
+        \\  z4 server --port 9670 --data ./data
         \\  z4 key create admin
         \\  z4 bucket create mybucket
         \\  z4 bucket allow mybucket --key admin --read --write
@@ -487,7 +487,7 @@ fn runServer(allocator: std.mem.Allocator, args: []const []const u8) !void {
     if (join_addr) |addr| {
         var iter = std.mem.splitScalar(u8, addr, ':');
         const host = iter.next() orelse "127.0.0.1";
-        const p_str = iter.next() orelse "8081";
+        const p_str = iter.next() orelse "9671";
         const p = try std.fmt.parseInt(u16, p_str, 10);
         try gossip.joinCluster(host, p);
     }

src/server.zig

@@ -634,7 +634,7 @@ pub const Server = struct {
         var xml_buffer = std.ArrayList(u8){};
         defer xml_buffer.deinit(self.allocator);
 
-        const location = std.fmt.allocPrint(self.allocator, "http://localhost:8080/{s}/{s}", .{ bucket, key }) catch return;
+        const location = std.fmt.allocPrint(self.allocator, "http://localhost:9670/{s}/{s}", .{ bucket, key }) catch return;
         defer self.allocator.free(location);
 
         s3.writeCompleteMultipartUploadResult(self.allocator, xml_buffer.writer(self.allocator), location, bucket, key, etag) catch {

tests/stress_memory.zig

@@ -9,7 +9,7 @@ pub fn main() !void {
     const args = try std.process.argsAlloc(allocator);
     defer std.process.argsFree(allocator, args);
 
-    var endpoint: []const u8 = "http://127.0.0.1:8080";
+    var endpoint: []const u8 = "http://127.0.0.1:9670";
     var concurrency: usize = 20;
     var size_mb: u64 = 100;
 
@@ -72,7 +72,7 @@ fn worker(allocator: std.mem.Allocator, endpoint_str: []const u8, size_mb: u64,
         return;
     };
     const hostname = if (uri.host) |h| h.percent_encoded else "localhost";
-    const port = uri.port orelse 8080;
+    const port = uri.port orelse 9670;
 
     const peer = std.net.Address.parseIp(hostname, port) catch |e| {
         std.debug.print("IP Parse Error (host={s}): {}\n", .{ hostname, e });

tests/test_aws_cli.sh

@@ -9,13 +9,13 @@ docker rm -f z4-aws-test 2>/dev/null || true
 
 echo "Starting Docker container with encryption enabled..."
 docker build -t z4:latest .
-docker run -d --name z4-aws-test -p 8080:8080 \
+docker run -d --name z4-aws-test -p 9670:9670 \
     -e Z4_ENCRYPTION_KEY=my-32-byte-encryption-key-here! \
     -v $(pwd)/data:/app/data z4:latest /app/z4 server
 
 echo "Waiting for service..."
 for i in {1..30}; do
-    if curl -s http://localhost:8080/ > /dev/null; then
+    if curl -s http://localhost:9670/ > /dev/null; then
         echo "Service is up!"
         break
     fi
@@ -37,21 +37,21 @@ echo "============================================="
 
 echo ""
 echo "1. Create bucket..."
-aws s3api create-bucket --bucket aws-test-bucket --endpoint-url http://localhost:8080 2>&1 || echo "Bucket exists or created"
+aws s3api create-bucket --bucket aws-test-bucket --endpoint-url http://localhost:9670 2>&1 || echo "Bucket exists or created"
 
 echo ""
 echo "2. List buckets..."
-aws s3api list-buckets --endpoint-url http://localhost:8080
+aws s3api list-buckets --endpoint-url http://localhost:9670
 
 echo ""
 echo "3. Put object..."
 echo "Hello from AWS CLI" > /tmp/test-file.txt
-aws s3api put-object --bucket aws-test-bucket --key test-awscli.txt --body /tmp/test-file.txt --endpoint-url http://localhost:8080
+aws s3api put-object --bucket aws-test-bucket --key test-awscli.txt --body /tmp/test-file.txt --endpoint-url http://localhost:9670
 echo "SUCCESS: Put object"
 
 echo ""
 echo "4. Get object..."
-aws s3api get-object --bucket aws-test-bucket --key test-awscli.txt /tmp/retrieved.txt --endpoint-url http://localhost:8080
+aws s3api get-object --bucket aws-test-bucket --key test-awscli.txt /tmp/retrieved.txt --endpoint-url http://localhost:9670
 cat /tmp/retrieved.txt
 if grep -q "AWS CLI" /tmp/retrieved.txt; then
     echo "SUCCESS: Get object content matches"
@@ -61,16 +61,16 @@ fi
 
 echo ""
 echo "5. Head object..."
-aws s3api head-object --bucket aws-test-bucket --key test-awscli.txt --endpoint-url http://localhost:8080
+aws s3api head-object --bucket aws-test-bucket --key test-awscli.txt --endpoint-url http://localhost:9670
 
 echo ""
 echo "6. Put bucket versioning..."
-aws s3api put-bucket-versioning --bucket aws-test-bucket --versioning-configuration Status=Enabled --endpoint-url http://localhost:8080
+aws s3api put-bucket-versioning --bucket aws-test-bucket --versioning-configuration Status=Enabled --endpoint-url http://localhost:9670
 echo "SUCCESS: Enabled versioning"
 
 echo ""
 echo "7. Get bucket versioning..."
-aws s3api get-bucket-versioning --bucket aws-test-bucket --endpoint-url http://localhost:8080
+aws s3api get-bucket-versioning --bucket aws-test-bucket --endpoint-url http://localhost:9670
 
 echo ""
 echo "8. Put bucket lifecycle..."
@@ -90,11 +90,11 @@ cat > /tmp/lifecycle.json << 'EOF'
   ]
 }
 EOF
-aws s3api put-bucket-lifecycle-configuration --bucket aws-test-bucket --lifecycle-configuration file:///tmp/lifecycle.json --endpoint-url http://localhost:8080 2>&1 || echo "Lifecycle set or format issue"
+aws s3api put-bucket-lifecycle-configuration --bucket aws-test-bucket --lifecycle-configuration file:///tmp/lifecycle.json --endpoint-url http://localhost:9670 2>&1 || echo "Lifecycle set or format issue"
 
 echo ""
 echo "9. Delete object..."
-aws s3api delete-object --bucket aws-test-bucket --key test-awscli.txt --endpoint-url http://localhost:8080
+aws s3api delete-object --bucket aws-test-bucket --key test-awscli.txt --endpoint-url http://localhost:9670
 echo "SUCCESS: Delete object"
 
 echo ""