Scan to join WeChat groupLocalStack 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_TOKENis set for Pro features