ESC
Start typing to search...

Docker Deployment

Deploy Teleton Agent using Docker for easy setup and portability.

Quick Start

Terminal
# Pull the image
docker pull ghcr.io/tonresistor/teleton-agent:latest

# Run with environment variables
docker run -d \
  --name teleton \
  -e ANTHROPIC_API_KEY=your_key \
  -e TG_API_ID=your_id \
  -e TG_API_HASH=your_hash \
  -v teleton-data:/root/.teleton \
  ghcr.io/tonresistor/teleton-agent:latest

Docker Compose

docker-compose.yml
version: '3.8'

services:
  teleton:
    image: ghcr.io/tonresistor/teleton-agent:latest
    container_name: teleton
    restart: unless-stopped
    environment:
      - ANTHROPIC_API_KEY=${ANTHROPIC_API_KEY}
      - TG_API_ID=${TG_API_ID}
      - TG_API_HASH=${TG_API_HASH}
    volumes:
      - ./data:/root/.teleton
      - ./config.yaml:/root/.teleton/config.yaml:ro
    ports:
      - "3000:3000"  # WebUI (optional)
.env
ANTHROPIC_API_KEY=sk-ant-...
TG_API_ID=12345678
TG_API_HASH=abcdef...
Terminal
# Start
docker compose up -d

# View logs
docker compose logs -f

# Stop
docker compose down

First Run Authentication

On first run, you need to authenticate with Telegram:

Terminal
# Run interactively for first-time setup
docker run -it \
  -e TG_API_ID=your_id \
  -e TG_API_HASH=your_hash \
  -v teleton-data:/root/.teleton \
  ghcr.io/tonresistor/teleton-agent:latest

# Follow prompts to enter phone number and code

Build From Source

Terminal
git clone https://github.com/TONresistor/teleton-agent.git
cd teleton-agent

# Build
docker build -t teleton-agent .

# Run
docker run -d --name teleton \
  -e ANTHROPIC_API_KEY=your_key \
  -v teleton-data:/root/.teleton \
  teleton-agent

Data Volumes

PathDescription
/root/.teleton/All persistent data
/root/.teleton/config.yamlConfiguration file
/root/.teleton/session.jsonTelegram session
/root/.teleton/wallet.jsonEncrypted wallet
/root/.teleton/memory.dbMemory database
Backup

Always backup the data volume, especially wallet.json and session.json.