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:/data \
  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}
      - TELETON_HOME=/data  # sets workspace root inside container (default: /data)
    volumes:
      - ./data:/data
      - ./config.yaml:/data/config.yaml:ro
    ports:
      - "7777:7777"  # 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:/data \
  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:/data \
  teleton-agent

Data Volumes

PathDescription
/data/All persistent data
/data/config.yamlConfiguration file
/data/session.jsonTelegram session
/data/wallet.jsonWallet keys (permissions 0o600)
/data/memory.dbMemory database
Backup

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