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:latestDocker 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 downFirst 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 codeBuild 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-agentData Volumes
| Path | Description |
|---|---|
/data/ | All persistent data |
/data/config.yaml | Configuration file |
/data/session.json | Telegram session |
/data/wallet.json | Wallet keys (permissions 0o600) |
/data/memory.db | Memory database |
Backup
Always backup the data volume, especially wallet.json and session.json.