A Terraform-based solution to deploy a Factorio server on AWS EC2 with HTTP API control for start, stop, and status operations.

• 🚀 Automated EC2 deployment with Factorio server
• 🌐 REST API via AWS API Gateway and Lambda
• ⚡ Start, stop, and status commands via HTTP requests
• 🔒 Secure infrastructure with proper IAM roles
• 📦 One-command deployment and destruction

Internet → API Gateway → Lambda → EC2 (Factorio Server) 

• EC2 Instance: Runs the Factorio headless server
• Lambda Function: Handles start/stop/status commands
• API Gateway: Provides HTTP endpoints
• VPC: Isolated network environment

• AWS CLI configured with appropriate permissions
• Terraform >= 1.0
• SSH key pair for EC2 access

1. Clone and setup:

   git clone <this-repo> cd factorio_aws_server

2. Configure variables:

   cp infrastructure/terraform.tfvars.example infrastructure/terraform.tfvars # Edit infrastructure/terraform.tfvars with your values

3. Deploy:

   ./deploy.sh

4. Test the API:

   ./test_api.sh

After deployment, you'll get three endpoints:

• POST /prod/server/start - Start the Factorio server
• POST /prod/server/stop - Stop the Factorio server
• POST /prod/server/status - Get server status

# Get server status curl -X POST https://your-api-id.execute-api.region.amazonaws.com/prod/server/status # Start server curl -X POST https://your-api-id.execute-api.region.amazonaws.com/prod/server/start # Stop server curl -X POST https://your-api-id.execute-api.region.amazonaws.com/prod/server/stop

aws_region = "us-east-1" # AWS region instance_type = "t3.medium" # EC2 instance type public_key = "ssh-rsa AAAA..." # Your SSH public key

Modify /opt/factorio/data/server-settings.json on the EC2 instance to customize:

• Server name and description
• Password protection
• Player limits
• Admin settings

Estimated AWS costs (us-east-1):

• EC2 t3.medium: ~$30/month (when running)
• Lambda: ~$0 (free tier covers typical usage)
• API Gateway: ~$0 (free tier covers typical usage)
• Data transfer: varies

💡 Tip: Stop the server when not in use to minimize costs!

├── infrastructure/ # Terraform infrastructure code │ ├── main.tf # Main Terraform configuration │ ├── variables.tf # Variable definitions │ ├── outputs.tf # Output definitions │ ├── user_data.sh # EC2 initialization script │ └── terraform.tfvars.example ├── lambda/ # Lambda function code │ ├── src/ │ │ └── lambda_function.py │ ├── requirements.txt │ └── README.md ├── scripts/ # Deployment and utility scripts │ ├── deploy.sh # Deployment script │ ├── destroy.sh # Destruction script │ ├── test_api.sh # API testing script │ └── README.md └── docs/ # Documentation ├── ARCHITECTURE.md # Architecture overview ├── DEPLOYMENT.md # Deployment guide └── API.md # API documentation 

To destroy all resources:

./destroy.sh

• Check EC2 instance logs: sudo journalctl -u factorio -f
• Ensure security group allows UDP port 34197

• Check Lambda logs in CloudWatch
• Verify IAM permissions

• Server takes 2-3 minutes to fully initialize
• Check server status via API first

• EC2 instance is in a public subnet for game access
• SSH access is restricted to your IP (modify security group as needed)
• Lambda has minimal required EC2 permissions
• No passwords are stored in code (configure in server settings)