Managing Multiple Instances

What Are Instances?

Instances allow running multiple isolated development environments simultaneously. Each instance:

• Uses different ports (offset by instance × 100)
• Has its own database
• Has its own file storage
• Runs independently

Port Mapping

Formula: Port = Base + (Instance × 100)

Commands

Start instance:

dev docker up -i 1 -d
dev docker up -i 2 -d

Check instance status:

dev docker ps -i 1

View instance logs:

dev docker logs -i 1 api

Stop instance:

dev docker down -i 1

Shell into instance:

dev docker shell -i 1 api

Use Cases

1. Testing different branches:

   • Instance 0: main branch
   • Instance 1: feature branch

2. Running parallel tests:

   • Instance 0: development
   • Instance 1: running test suite

3. Comparing behavior:

   • Instance 0: before changes
   • Instance 1: after changes

Resource Considerations

Each instance uses:

• ~2GB memory for full stack
• Separate disk space for volumes
• Independent CPU allocation

Limit to 2-3 instances on typical development machines.