localstack

LocalStack Lifecycle Management

Manage the LocalStack container lifecycle including starting, stopping, and monitoring the local cloud environment.

Capabilities

• Start LocalStack with custom configuration
• Stop running LocalStack instances
• Check LocalStack status and health
• Restart LocalStack with new settings
• View LocalStack version and configuration

Common Commands

Start LocalStack

# Basic start
localstack start -d

# Start with debug mode
DEBUG=1 localstack start -d

# Start with Pro features (requires auth token)
LOCALSTACK_AUTH_TOKEN=<token> localstack start -d

Check Status

# Check if LocalStack is running
localstack status

# Check service health
curl http://localhost:4566/_localstack/health

# View running Docker container
docker ps | grep localstack

Stop LocalStack

# Graceful stop
localstack stop

# Force stop via Docker
docker stop localstack-main

View Logs

# Follow logs
localstack logs -f

# View last 100 lines
localstack logs --tail 100

Configuration Options

Key environment variables for LocalStack:

Variable	Description	Default
DEBUG	Enable debug logging	0
PERSISTENCE	Enable persistence across restarts	0
LOCALSTACK_AUTH_TOKEN	Auth token for Pro features	None
GATEWAY_LISTEN	Port configuration	4566

Troubleshooting

• Container won't start: Check if port 4566 is already in use
• Services unavailable: Verify Docker is running and has sufficient resources
• Auth errors: Ensure LOCALSTACK_AUTH_TOKEN is set for Pro features