# Docker Installation Guide

### Quick Start (5 Minutes)

Get AunooAI running using the pre-built Docker Hub image.

#### Prerequisites

* Docker Engine 20.10+ and Docker Compose v2+
* 4GB RAM minimum (8GB recommended)
* 10GB disk space

#### Installation Steps

1. Download the configuration files

```
# Create directory
mkdir aunooai && cd aunooai
# Download docker-compose.yml
curl -O https://github.com/AuNooAI/AunooAI/blob/main/docker-compose.yml
mv docker-compose.hub.yml docker-compose.yml
# Download .env template
curl -O https://github.com/AuNooAI/AunooAI/blob/main/.env.hub
cp .env.hub .env
```

2. Configure settings

```
nano .env
```

Required changes:

* POSTGRES\_PASSWORD: Change from default aunoo\_secure\_2025
* ADMIN\_PASSWORD: Change from default admin123

3. Start the application

```
docker-compose up -d
```

4. Access AunooAI

* URL: <http://localhost:10001>
* Username: admin
* Password: (what you set in ADMIN\_PASSWORD)

5. Configure API keys

* Log in to the application
* Go to Settings → AI-guided Topic Setup
* Add your API keys (OpenAI, Anthropic, NewsAPI, Firecrawl)
* Keys are saved in a persistent Docker volume

That's it! You're now running AunooAI Community Edition.

***

### Docker Hub Image

Image: aunooai/aunoo-community:latest\
Pre-built images are available at: <https://hub.docker.com/repository/docker/aunooai/aunoo-community>

Tags:

* latest - Most recent stable release (recommended)
* v1.x.x - Specific version tags
* dev - Development/testing builds (not recommended for production)

***

### Configuration

#### Environment Variables

Edit .env to customize your deployment:

Required Settings:

```
# Database password (CHANGE THIS!)
POSTGRES_PASSWORD=your-secure-password
# Admin login password (CHANGE THIS!)
ADMIN_PASSWORD=your-admin-password
# Application port
APP_PORT=10001
# PostgreSQL port (change if 5432 is in use)
POSTGRES_PORT=5433
API Keys (configure via web interface after first login):
# AI Providers (at least one required)
OPENAI_API_KEY=
ANTHROPIC_API_KEY=
GEMINI_API_KEY=
# News Providers (at least one required)
NEWSAPI_KEY=
THENEWSAPI_KEY=
NEWSDATA_API_KEY=
# Web Scraping (required)
FIRECRAWL_API_KEY=
# Optional
ELEVENLABS_API_KEY=    # For audio/podcast generation
# Database Settings:
POSTGRES_USER=aunoo_user
POSTGRES_DB=aunoo_db
DB_POOL_SIZE=20
DB_MAX_OVERFLOW=10
```

***

### Common Commands

#### Start/Stop Services

```
# Start all services
docker-compose up -d
# Stop all services
docker-compose down
# Restart application only
docker-compose restart aunooai
# Restart everything
docker-compose restart
```

#### View Logs

```
# All services
docker-compose logs -f
# Application only
docker-compose logs -f aunooai
# PostgreSQL only
docker-compose logs -f postgres
# Last 100 lines
docker-compose logs --tail=100 aunooai
```

#### Update to Latest Version

```
# Pull latest image
docker-compose pull aunooai
# Restart with new image
docker-compose up -d aunooai
```

***

### Data Persistence

#### Docker Volumes

Your data is stored in Docker volumes:

* postgres\_data - Database files
* aunooai\_data - SQLite files, uploads
* aunooai\_reports - Generated reports
* aunooai\_env - API keys and configuration
* aunooai\_config - Application settings

List volumes:

```
docker volume ls | grep aunooai
```

#### Backup Data

Backup database:

```
# Create backup file
docker-compose exec postgres pg_dump -U aunoo_user aunoo_db > aunoo_backup_$(date +%Y%m%d).sql
# Or with compression
docker-compose exec postgres pg_dump -U aunoo_user aunoo_db | gzip > aunoo_backup_$(date +%Y%m%d).sql.gz
```

Backup volumes:

```
# Backup all volumes
docker run --rm -v aunooai_data:/data -v $(pwd):/backup \
alpine tar czf /backup/aunooai_volumes_$(date +%Y%m%d).tar.gz -C / data
# Backup specific volume
docker run --rm -v aunooai_env:/data -v $(pwd):/backup \
  alpine tar czf /backup/aunooai_env_$(date +%Y%m%d).tar.gz -C /data .
```

#### Restore Data

Restore database:

```
# From SQL file
docker-compose exec -T postgres psql -U aunoo_user aunoo_db < aunoo_backup.sql
# From compressed file
gunzip -c aunoo_backup.sql.gz | docker-compose exec -T postgres psql -U aunoo_user aunoo_db
```

Restore volume:

```
# Stop application first
docker-compose down aunooai
# Restore volume
docker run --rm -v aunooai_env:/data -v $(pwd):/backup \
  alpine tar xzf /backup/aunooai_env_backup.tar.gz -C /data
# Restart
docker-compose up -d
```

***

### Troubleshooting

#### Application won't start

Check logs:

```
docker-compose logs aunooai
```

#### &#x20;Port already in use

* Change APP\_PORT in .env
* Change POSTGRES\_PORT if PostgreSQL port conflicts

#### Database connection failed

```
# Check PostgreSQL is healthy
docker-compose ps postgres
# Wait for health check (may take 30s)
docker-compose logs postgres | grep "ready to accept connections"
```

#### Permission errors

```
# Fix volume permissions
docker-compose down
docker volume rm aunooai_data aunooai_reports
docker-compose up -d
```

#### Can't log in

Reset admin password:

```
# Stop application
docker-compose down aunooai
# Update .env with new ADMIN_PASSWORD
nano .env
# Restart
docker-compose up -d aunooai
```

#### Database errors

Check PostgreSQL logs:

```
docker-compose logs postgres | grep ERROR
```

Connect to database:

```
docker-compose exec postgres psql -U aunoo_user aunoo_db
```

Check connection pool:

```
# Inside PostgreSQL
SELECT count(*) FROM pg_stat_activity WHERE datname = 'aunoo_db';
```

***

### Upgrading

#### To Latest Version

```
# Backup first!
docker-compose exec postgres pg_dump -U aunoo_user aunoo_db > backup_before_upgrade.sql
# Pull latest image
docker-compose pull aunooai
# Stop and restart with new image
docker-compose down aunooai
docker-compose up -d aunooai
# Check logs
docker-compose logs -f aunooai
```

#### To Specific Version

```
# Edit docker-compose.yml
nano docker-compose.yml
# Change image line:
# image: aunooai/aunoo-community:v1.2.3
# Pull and restart
docker-compose pull aunooai
docker-compose up -d aunooai
```

#### Rollback

```
# Stop application
docker-compose down aunooai
# Edit docker-compose.yml to previous version
nano docker-compose.yml
# Restore database if needed
docker-compose exec -T postgres psql -U aunoo_user aunoo_db < backup_before_upgrade.sql
# Start with old version
docker-compose up -d aunooai
```

***

### Advanced Configuration

#### Custom Ports

Edit docker-compose.yml:

```
services:
 aunooai:
 ports:
  - "8080:10001"  # Access at localhost:8080
```

#### Multiple Instances

Run multiple AunooAI instances:

```
# Create separate directories
mkdir aunooai-prod aunooai-dev
# Copy files to each
cp docker-compose.yml aunooai-prod/
cp docker-compose.yml aunooai-dev/
# Edit .env in each with different ports
# aunooai-prod/.env: APP_PORT=10001, POSTGRES_PORT=5433
# aunooai-dev/.env: APP_PORT=10002, POSTGRES_PORT=5434
# Start each instance
cd aunooai-prod && docker-compose up -d
cd ../aunooai-dev && docker-compose up -d
```

#### Resource Limits

Edit docker-compose.yml to add resource limits:

```
services:
  aunooai:
    deploy:
      resources:
        limits:
          cpus: '2.0'
          memory: 4G
        reservations:
          cpus: '1.0'
          memory: 2G
```

***

### Getting Help

Application Issues:

* Check logs: docker-compose logs -f aunooai
* Health status: curl <http://localhost:10001/health>
* [Getting Started Guide](https://docs.google.com/document/d/1Rkk_Hz4fXedv-J4-R_h_cTaLuQWJWsBEc6GreckkinM/edit?tab=t.0)
* [Operations HQ](https://docs.google.com/document/d/1Rkk_Hz4fXedv-J4-R_h_cTaLuQWJWsBEc6GreckkinM/edit?tab=t.ijpfkxcdprf) - System health monitoring

Docker Issues:

* System status: docker-compose ps
* Resource usage: docker stats
* Disk space: docker system df

<br>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://aunoo-ai.gitbook.io/aunoo-ai-kb/docker-installation-guide.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.