Troubleshooting

Start here when something goes wrong. Find your symptom below and follow the link.

Common Symptoms

Symptom	Page
Port 4599 already in use	Common Issues
"Access Denied" errors	Common Issues
S3 operations failing	Common Issues
Health check returns 503	Common Issues
Credential or signing errors	Common Issues
State missing after restart	Common Issues

Docker Symptoms

Symptom	Page
Docker socket not found	Docker Issues
Image pull failures	Docker Issues
Container startup failures	Docker Issues
Port conflicts	Docker Issues
VPC network problems	Docker Issues
Containers not starting	Docker Issues

Terraform Symptoms

Symptom	Page
"no valid credential sources found"	Terraform Issues
"InvalidClientTokenId"	Terraform Issues
S3 backend not working	Terraform Issues
"ResourceNotFoundException"	Terraform Issues
Provider version issues	Terraform Issues
Missing endpoints block	Terraform Issues