Deploy reNgine on AWS

Overview

This tutorial guides you through deploying reNgine Cloud on AWS using our pre-configured CloudFormation template. The deployment includes EC2 instance, RDS PostgreSQL database, ElastiCache Redis for Celery task queue, and docker-compose orchestration for all reconnaissance services.

Step 1: Access AWS CloudFormation

Log into your AWS Console and navigate to the CloudFormation service. Select a region with good performance for your location (us-east-1, us-west-2, or eu-west-1 recommended).

Step 2: Upload HailBytes Template

Download our CloudFormation template and upload it to AWS:

# Download template
curl -O https://hailbytes.com/templates/rengine-cloudformation.yaml

# Or use AWS CLI
aws cloudformation create-stack \
  --stack-name rengine-production \
  --template-url https://hailbytes.com/templates/rengine-cloudformation.yaml \
  --parameters \
    ParameterKey=InstanceType,ParameterValue=t3.large \
    ParameterKey=DBInstanceClass,ParameterValue=db.t3.medium \
  --capabilities CAPABILITY_IAM

Upload the file in the CloudFormation console and click "Next".

Step 3: Configure Stack Parameters

Set the following parameters for your reNgine deployment:

Step 4: Review and Deploy

Review your configuration and launch the stack. Deployment typically takes 5-8 minutes.

Step 5: Access Your reNgine Dashboard

Once deployment completes, access your reNgine instance using the provided URLs.

# Get outputs from CloudFormation
aws cloudformation describe-stacks \
  --stack-name rengine-production \
  --query 'Stacks[0].Outputs'

# Outputs:
# - WebURL: https://rengine.yourcompany.com
# - AdminURL: https://rengine.yourcompany.com:8000/admin
# - DatabaseEndpoint: rengine-db.abc123.us-east-1.rds.amazonaws.com
# - RedisEndpoint: rengine-redis.abc123.cache.amazonaws.com
# - DefaultUsername: admin
# - DefaultPassword: (check CloudFormation outputs or EC2 user data)

Navigate to the Web URL in your browser and log in with the default credentials. You'll be prompted to change your password on first login.

Understanding the Architecture

reNgine Cloud uses a containerized architecture managed by docker-compose:

# SSH into your instance to view running containers
ssh -i your-key.pem ec2-user@

# View docker-compose services
cd /opt/rengine
docker-compose ps

# Expected output:
NAME                STATUS              PORTS
rengine-web        Up 5 minutes        0.0.0.0:8000->8000/tcp
rengine-celery     Up 5 minutes
rengine-celery-beat Up 5 minutes
rengine-redis      Up 5 minutes        0.0.0.0:6379->6379/tcp
rengine-proxy      Up 5 minutes        0.0.0.0:80->80/tcp, 0.0.0.0:443->443/tcp

Post-Deployment Configuration

Complete these steps to secure and optimize your deployment:

Configure SSL with Let's Encrypt

Set up free SSL certificates for your reNgine instance:

# SSH into EC2 instance
ssh -i your-key.pem ec2-user@

# Update domain in NGINX configuration
sudo nano /opt/rengine/nginx/rengine.conf

# Update server_name directive
server_name rengine.yourcompany.com;

# Install certbot
sudo yum install -y certbot python3-certbot-nginx

# Generate certificate
sudo certbot --nginx -d rengine.yourcompany.com

# Follow prompts to complete setup
# Certbot will automatically configure NGINX and set up auto-renewal

Ensure your domain's DNS A record points to your Elastic IP before running certbot.

Troubleshooting

Cost Estimation

Monthly AWS costs for typical reNgine deployment:

Next Steps