Deka

Self-hosted deployment tool for Tana. Run your own Tana hosting stack with Docker.

Installation

npm install -g @tananetwork/deka

Or build from source:

bun install
bun run build  # Output: dist/deka

Quick Start

# Interactive setup (first time)
deka setup

# Start all services
deka start

# Check status
deka status

Services

Deka manages 6 Docker services:

| Service | Port | Description | |---------|------|-------------| | postgres | 5432 | PostgreSQL database | | redis | 6379 | Queue and cache | | edge | 8506 | Site execution (V8 isolates) | | t4 | 8507 | Content-addressable storage | | deka-git | 8508 | Git server for deployments | | deploy | 8509 | Build execution service |

Commands

deka setup              # Interactive first-run configuration
deka start              # Start all services
deka start --infra      # Start only postgres/redis (for local dev)
deka stop [services]    # Stop services (or 'all')
deka stop all --volumes # Stop and delete all data
deka status             # Show service status
deka logs [service]     # View logs (-f to follow)
deka restart [services] # Restart services
deka check              # Check for image updates
deka update             # Pull latest images
deka upgrade            # Pull and restart outdated services
deka monitor start      # Enable automatic update checks

Status Detection

deka status detects services regardless of how they were started:

● [postgres] healthy :5432 (via td)
● [redis] healthy :6379 (via td)
● [edge] running :8506 (native)
● [t4] running :8507 (native)
● [deka-git] running :8508 (native)
● [deploy] running :8509 (native)

• (via td) - Running as a Docker container started by td
• (native) - Running as a native binary (detected via port)
• No tag - Running as a deka-managed container

Configuration

Config stored in ~/.config/deka/:

• config.json - Registry and service settings
• docker-compose.yml - Generated compose file

Deka vs td

| | Deka | td | |--|------|-----| | Purpose | Self-hosted production | Local development | | Runs | Docker containers only | Docker or native binaries | | Services | Hosting stack (6) | Full node (12+) | | Container prefix | deka-* | tana-* | | Config | ~/.config/deka | ~/.config/td |

Use td for local development, deka for self-hosted deployments.

Troubleshooting

Services won't start:

docker info              # Verify Docker is running
lsof -i :8506            # Check port conflicts
deka logs <service>      # View service logs

Authentication errors:

deka setup               # Re-configure registry auth
docker login ghcr.io     # Or login manually