Skip to main content

​
Overview

The simplest way to get AgentOS up and running. All platform components run as Docker containers on a single machine using Docker Compose. Best for: Development, small teams, single-server deployments.
AgentOS Platform Overview

​
Prerequisites

  • Docker (latest version recommended)
  • Docker Compose V2
  • Minimum 4GB RAM
  • Minimum 30GB disk space

​
Docker Hub Access

Log in to Docker Hub to pull AgentOS images: 
docker login -u getupsonic
Contact the Upsonic team for access credentials.

​
Start Installation

1

Download Installation Files

Clone the AgentOS Builder repository:
git clone https://github.com/Upsonic/AgentOS-Builder.git
cd AgentOS-Builder
You’ll find compose.yml and upsonic-start.sh in the repository.
2

Run Installation Wizard

Make the script executable and run it:
chmod +x upsonic-start.sh
./upsonic-start.sh
The wizard will verify prerequisites and guide you through configuration.
3

Configure Admin Account

Create your admin account:
  • Enter admin email address
  • Set admin password (minimum 8 characters)
These credentials will be used to access the AgentOS management interface.
4

Configure SMTP (Optional)

Configure email notifications:
  • Skip: Emails will be logged to console (development mode)
  • Configure: Enter SMTP host, port, username, and password for email alerts
You can configure this later in the platform settings.
5

Platform Selection

Choose your system architecture:
  • Linux (AMD64) — For Intel/AMD processors
  • Mac (ARM64) — For Apple Silicon (M1/M2/M3)
The wizard will pull the appropriate Docker images for your platform.
6

Server Configuration

Configure network access:
  • IP Address: Server address (e.g., 0.0.0.0, 192.168.1.50)
  • Port: Platform port (default: 80, use 8080 if port 80 is in use)
The wizard automatically generates secure database passwords and security tokens.
Docker Installation Wizard

​
Access Your AgentOS

Once the installation wizard completes, you’ll see the access URL displayed in the terminal. Open your browser and navigate to the URL provided (typically http://IP:PORT). Log in using the admin credentials you created during installation.
AgentOS First Login Screen

​
Next Steps

Deploy Your First Agent

Create and deploy your first AI agent

Configure Git Provider

Connect GitHub, GitLab, or Azure Repos

Setup LLM Connection

Configure OpenAI, Anthropic, or local models

Kubernetes Installation

Deploy on Kubernetes for production scale