Installation

Docker

docker run -d --name simfra -p 4599:4599 -e SIMFRA_BOOTSTRAP=standard ghcr.io/simfra-dev/simfra:latest

SIMFRA_BOOTSTRAP=standard creates a default VPC, subnets, internet gateway, route table, security group, and network ACL in us-east-1 - matching what a real AWS account provides out of the box.

To persist data across restarts, mount a volume:

docker run -d --name simfra -p 4599:4599 \
  -e SIMFRA_BOOTSTRAP=standard \
  -e SIMFRA_DATA_DIR=/data \
  -v simfra-data:/data \
  ghcr.io/simfra-dev/simfra:latest

Verify

curl http://localhost:4599/_simfra/health

A healthy instance returns:

{"status":"healthy"}

You can also verify with the AWS CLI:

AWS_ENDPOINT_URL=http://localhost:4599 \
AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE \
AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY \
  aws sts get-caller-identity

Next Steps