​

Option 1 — One-Click Installation (Recommended)

​

1. Prepare your server

• Provision a Linux server (Ubuntu, Debian, or Amazon Linux 2023)
• Point the following DNS records to your server’s public IP:
  • api.example.com
  • app.example.com
  • cdn.example.com
  • logs.example.com
• Open the following ports in your firewall/security group:
  • TCP 80
  • TCP 443
  • UDP 443 (optional for HTTP/3)

​

2. Clone the repository

git clone https://github.com/InteraOne/InteraOne.git
cd InteraOne

​

3. Run the installer

sudo ./install.sh

• Installs Docker (if required)
• Installs Docker Compose (if required)
• Generates secure passwords and secrets
• Creates docker/.env
• Creates all required *.env.docker files
• Configures every InteraOne service
• Pulls all Docker images
• Starts the complete production stack

​

4. Installer Configuration

​

Domains

• API Domain
• Web Console Domain
• CDN Domain
• Log Viewer Domain

​

Email Provider

• Amazon SES
• MailHog
• Disabled

​

AI Provider

• Google Gemini
• OpenAI
• AWS Bedrock
• Hugging Face
• Ollama

• API Keys
• Model names
• Embedding model
• AWS credentials (if applicable)

• MongoDB password
• Redis password
• MinIO password
• JWT secret
• Internal service secrets
• Dozzle authentication

​

5. Amazon SES (Optional)

• Verified sender identity
• AWS IAM credentials
• SNS Topic
• SES Event Notifications (Bounce, Complaint, Delivery)

​

Option 2 — Manual Installation

​

1. Clone the repository

git clone https://github.com/InteraOne/InteraOne.git
cd InteraOne

​

2. Configure Docker environment

docker/.env

• Domains
• Database passwords
• Redis password
• MinIO credentials
• JWT secrets
• AI tool secret

​

3. Configure service environments

• apps/gateway/.env.docker
• apps/agent/.env.docker
• apps/console/.env.docker
• apps/worker/.env.docker
• apps/launcher/.env.docker

• AI provider
• API keys
• Database connections
• Redis
• Object storage
• Vector database
• Email provider
• Public URLs

​

4. Configure DNS

• API
• Web Console
• CDN
• Log Viewer

• TCP 80
• TCP 443

​

5. Pull Docker images

docker compose pull

​

6. Start the platform

docker compose up -d

​

Verify Installation

docker compose ps

curl https://YOUR_API_HOST/api/v1/health

{
  "success": true,
  "message": "API is healthy",
  "timestamp": "2026-07-18T05:21:32.499Z"
}