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