Architecture
The reference deployment consists of:- Amazon EC2
- Docker Compose
- Caddy (Automatic HTTPS)
- MongoDB
- Redis
- MinIO
- Qdrant
- Gateway
- AI Agent
- Worker
- Console
Prerequisites
Before starting, you’ll need:- An AWS Account
- A registered domain name
- Route53 (or any DNS provider)
- An AI provider (Gemini, OpenAI, Bedrock, Ollama, etc.)
Step 1 — Launch an EC2 Instance
Recommended minimum:
Assign an Elastic IP so your server IP remains static.
Step 2 — Configure Security Groups
Allow inbound traffic:
Do not expose MongoDB, Redis, MinIO, or Qdrant directly to the internet.
Step 3 — Configure DNS
Create DNS records pointing to your EC2 Elastic IP.
Caddy will automatically obtain SSL certificates once DNS propagation is complete.
Step 4 — Connect to the Server
Step 5 — Clone InteraOne
Step 6 — Install InteraOne
Run:- Install Docker (if necessary)
- Install Docker Compose
- Ask for your deployment configuration
- Generate secure passwords
- Create all production
.envfiles - Pull Docker images
- Start every InteraOne service
Step 7 — Installer Questions
During installation you’ll configure:Domains
- API Domain
- Console Domain
- CDN Domain
- Log Viewer Domain
Email Provider
Choose one:- Amazon SES
- MailHog
- Disabled
AI Provider
Choose one:- Google Gemini
- OpenAI
- AWS Bedrock
- Hugging Face
- Ollama
- API Keys
- Model
- Embedding Model
- AWS Credentials (if applicable)
Step 8 — Amazon SES (Optional)
If you use Amazon SES:- Verify your sender domain
- Create an IAM user
- Configure SES credentials
- Configure an SNS Topic
- Enable Bounce, Complaint, and Delivery notifications
Step 9 — Verify the Deployment
Check the running services:Backups
The following services contain persistent data and should be backed up regularly:- MongoDB
- MinIO
- Redis
- Qdrant
Next Steps
- Configure your AI provider
- Create your first knowledge base
- Install the Web Widget
- Configure email
- Set up automated backups
- Enable monitoring and alerts
- Review the Production Architecture guide