Install

Homebrew (pilot)

brew tap TeleosApp/tap https://github.com/TeleosApp/homebrew-tap
brew trust teleosapp/tap            # Homebrew 7+ asks you to trust third-party taps
brew install teleos

teleos doctor                       # checks Docker, gh, package access, release access

brew install teleos installs the launcher, a small script that runs the signed Teleos container. Upgrades: brew upgrade teleos && teleos upgrade.

Two ways to use it

One-shot scan, nothing installed:

teleos scan rails/rails --days 30
teleos scan your-org/your-repo --json   # machine-readable, for agents

A local instance with the web UI:

teleos up        # writes ~/.teleos/{docker-compose.yml,.env}, starts, creates your admin account
teleos open      # http://localhost:8000

Verify before you run it

Every release is signed and carries two bills of materials:

teleos verify    # checksums, signed checksums, and the image signature
teleos sbom      # what's inside the container
teleos sbom --app   # the source dependencies

See Security & verification.

Manual Docker Compose

If you manage the files yourself, pin a released version (never latest):

services:
  teleos:
    image: ghcr.io/teleosapp/teleos:0.3.3
    container_name: teleos
    ports:
      - "${PORT:-8000}:8000"
    env_file:
      - .env
    environment:
      DATABASE_PATH: /app/data/db.sqlite3
    volumes:
      - teleos-data:/app/data
    restart: unless-stopped

volumes:
  teleos-data:

Then create .env (see Environment variables) and run docker compose up -d.