Network Management

Each sandbox declares the ports its services listen on. Stackie automatically allocates free host ports and forwards traffic into the sandbox.

Port Allocation

When a block declares ports in its stack file, Stackie assigns available host ports and sets up forwarding:

# stackie-stack.yml
my-project:
  blocks:
    stackie.postgres:
      serves:
        PORT: { port: 5432, type: db }
    my-api:
      serves:
        HTTP: { port: 8080, type: web }

Checking Port Assignments

# See which host ports map to which sandbox ports
stackie ps

Port forwarding starts automatically with stackie up and stops with stackie down. Connectivity checks run as part of health monitoring to verify that forwarded ports are reachable.