Skip to main content
InteraOne provides two installation methods. Both deploy the same Docker Compose stack—the only difference is how the environment is configured.

​
Option 1 — One-Click Installation (Recommended)

The easiest way to deploy InteraOne is with the automated installer.

​
1. Prepare your server

Before running the installer:
  • 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

​
3. Run the installer

The installer automatically:
  • 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

During installation you’ll be prompted for the following information.

​
Domains

  • API Domain
  • Web 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
Depending on your provider, you’ll also provide:
  • API Keys
  • Model names
  • Embedding model
  • AWS credentials (if applicable)
The installer automatically generates all remaining secrets including:
  • MongoDB password
  • Redis password
  • MinIO password
  • JWT secret
  • Internal service secrets
  • Dozzle authentication

​
5. Amazon SES (Optional)

If you select Amazon SES, configure:
  • Verified sender identity
  • AWS IAM credentials
  • SNS Topic
  • SES Event Notifications (Bounce, Complaint, Delivery)
This allows InteraOne to properly process email events.

​
Option 2 — Manual Installation

For users who want complete control over the deployment.

​
1. Clone the repository

​
2. Configure Docker environment

Create and update:
Configure:
  • Domains
  • Database passwords
  • Redis password
  • MinIO credentials
  • JWT secrets
  • AI tool secret

​
3. Configure service environments

Update every required .env.docker file. For example:
  • apps/gateway/.env.docker
  • apps/agent/.env.docker
  • apps/console/.env.docker
  • apps/worker/.env.docker
  • apps/launcher/.env.docker
Configure:
  • AI provider
  • API keys
  • Database connections
  • Redis
  • Object storage
  • Vector database
  • Email provider
  • Public URLs

​
4. Configure DNS

Point the following domains to your server.
  • API
  • Web Console
  • CDN
  • Log Viewer
Open ports:
  • TCP 80
  • TCP 443

​
5. Pull Docker images

From the docker/ directory:

​
6. Start the platform

​
Verify Installation

Check the running containers.
Verify the Gateway.
Expected response:
Once the health check succeeds, open the Web Console, create your first organization, configure your AI provider, and start using InteraOne.
Last modified on July 18, 2026