tela

Self-hostable, markdown-native team wiki with live collaboration, full-text and semantic search, WebDAV sync, public spaces, Slidev decks, PDF export, and a built-in MCP server so AI agents are first-class editors.

Configuration

services:
  proxy:
    image: ghcr.io/zcag/tela-proxy:0.7.0
    restart: unless-stopped
    environment:
      - TELA_SITE_ADDRESS=:80
      - TELA_UPSTREAM_BACKEND=backend:8080
      - TELA_UPSTREAM_FRONTEND=frontend:80
    depends_on:
      - backend
      - frontend
    volumes:
      - caddy-data:/data
      - caddy-config:/config

  backend:
    image: ghcr.io/zcag/tela-backend:0.7.0
    restart: unless-stopped
    environment:
      - TELA_PUBLIC_BASE_URL=${TELA_PUBLIC_BASE_URL}
      - TELA_DATABASE_URL=postgres://tela:${TELA_PG_PASSWORD}@postgres:5432/tela?sslmode=disable
      - TELA_SHARE_SECRET=${TELA_SHARE_SECRET}
      - TELA_API_KEY_SECRET=${TELA_API_KEY_SECRET}
      - TELA_DECK_URL=http://deck:3344
      - TELA_GOTENBERG_URL=http://gotenberg:3000
      - TELA_PDF_RENDER_BASE_URL=http://proxy
    depends_on:
      postgres:
        condition: service_healthy

  frontend:
    image: ghcr.io/zcag/tela-frontend:0.7.0
    restart: unless-stopped

  postgres:
    image: pgvector/pgvector:pg17
    restart: unless-stopped
    environment:
      - POSTGRES_USER=tela
      - POSTGRES_PASSWORD=${TELA_PG_PASSWORD}
      - POSTGRES_DB=tela
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U tela -d tela"]
      interval: 5s
      timeout: 5s
      retries: 20
      start_period: 10s
    volumes:
      - pgdata:/var/lib/postgresql/data

  deck:
    image: ghcr.io/zcag/tela-deck:0.7.0
    restart: unless-stopped
    volumes:
      - deckcache:/data

  gotenberg:
    image: gotenberg/gotenberg:8
    restart: unless-stopped

volumes:
  pgdata:
  deckcache:
  caddy-data:
  caddy-config:

[variables]
main_domain = "${domain}"
pg_password = "${password:32}"
share_secret = "${password:64}"
api_key_secret = "${password:64}"

[config]
env = [
  "TELA_PUBLIC_BASE_URL=https://${main_domain}",
  "TELA_PG_PASSWORD=${pg_password}",
  "TELA_SHARE_SECRET=${share_secret}",
  "TELA_API_KEY_SECRET=${api_key_secret}",
]

[[config.domains]]
serviceName = "proxy"
port = 80
host = "${main_domain}"

Base64

To import this template in Dokploy: create a Compose service → Advanced → Base64 import and paste the content below:

ewogICJjb21wb3NlIjogInNlcnZpY2VzOlxuICBwcm94eTpcbiAgICBpbWFnZTogZ2hjci5pby96Y2FnL3RlbGEtcHJveHk6MC43LjBcbiAgICByZXN0YXJ0OiB1bmxlc3Mtc3RvcHBlZFxuICAgIGVudmlyb25tZW50OlxuICAgICAgLSBURUxBX1NJVEVfQUREUkVTUz06ODBcbiAgICAgIC0gVEVMQV9VUFNUUkVBTV9CQUNLRU5EPWJhY2tlbmQ6ODA4MFxuICAgICAgLSBURUxBX1VQU1RSRUFNX0ZST05URU5EPWZyb250ZW5kOjgwXG4gICAgZGVwZW5kc19vbjpcbiAgICAgIC0gYmFja2VuZFxuICAgICAgLSBmcm9udGVuZFxuICAgIHZvbHVtZXM6XG4gICAgICAtIGNhZGR5LWRhdGE6L2RhdGFcbiAgICAgIC0gY2FkZHktY29uZmlnOi9jb25maWdcblxuICBiYWNrZW5kOlxuICAgIGltYWdlOiBnaGNyLmlvL3pjYWcvdGVsYS1iYWNrZW5kOjAuNy4wXG4gICAgcmVzdGFydDogdW5sZXNzLXN0b3BwZWRcbiAgICBlbnZpcm9ubWVudDpcbiAgICAgIC0gVEVMQV9QVUJMSUNfQkFTRV9VUkw9JHtURUxBX1BVQkxJQ19CQVNFX1VSTH1cbiAgICAgIC0gVEVMQV9EQVRBQkFTRV9VUkw9cG9zdGdyZXM6Ly90ZWxhOiR7VEVMQV9QR19QQVNTV09SRH1AcG9zdGdyZXM6NTQzMi90ZWxhP3NzbG1vZGU9ZGlzYWJsZVxuICAgICAgLSBURUxBX1NIQVJFX1NFQ1JFVD0ke1RFTEFfU0hBUkVfU0VDUkVUfVxuICAgICAgLSBURUxBX0FQSV9LRVlfU0VDUkVUPSR7VEVMQV9BUElfS0VZX1NFQ1JFVH1cbiAgICAgIC0gVEVMQV9ERUNLX1VSTD1odHRwOi8vZGVjazozMzQ0XG4gICAgICAtIFRFTEFfR09URU5CRVJHX1VSTD1odHRwOi8vZ290ZW5iZXJnOjMwMDBcbiAgICAgIC0gVEVMQV9QREZfUkVOREVSX0JBU0VfVVJMPWh0dHA6Ly9wcm94eVxuICAgIGRlcGVuZHNfb246XG4gICAgICBwb3N0Z3JlczpcbiAgICAgICAgY29uZGl0aW9uOiBzZXJ2aWNlX2hlYWx0aHlcblxuICBmcm9udGVuZDpcbiAgICBpbWFnZTogZ2hjci5pby96Y2FnL3RlbGEtZnJvbnRlbmQ6MC43LjBcbiAgICByZXN0YXJ0OiB1bmxlc3Mtc3RvcHBlZFxuXG4gIHBvc3RncmVzOlxuICAgIGltYWdlOiBwZ3ZlY3Rvci9wZ3ZlY3RvcjpwZzE3XG4gICAgcmVzdGFydDogdW5sZXNzLXN0b3BwZWRcbiAgICBlbnZpcm9ubWVudDpcbiAgICAgIC0gUE9TVEdSRVNfVVNFUj10ZWxhXG4gICAgICAtIFBPU1RHUkVTX1BBU1NXT1JEPSR7VEVMQV9QR19QQVNTV09SRH1cbiAgICAgIC0gUE9TVEdSRVNfREI9dGVsYVxuICAgIGhlYWx0aGNoZWNrOlxuICAgICAgdGVzdDogW1wiQ01ELVNIRUxMXCIsIFwicGdfaXNyZWFkeSAtVSB0ZWxhIC1kIHRlbGFcIl1cbiAgICAgIGludGVydmFsOiA1c1xuICAgICAgdGltZW91dDogNXNcbiAgICAgIHJldHJpZXM6IDIwXG4gICAgICBzdGFydF9wZXJpb2Q6IDEwc1xuICAgIHZvbHVtZXM6XG4gICAgICAtIHBnZGF0YTovdmFyL2xpYi9wb3N0Z3Jlc3FsL2RhdGFcblxuICBkZWNrOlxuICAgIGltYWdlOiBnaGNyLmlvL3pjYWcvdGVsYS1kZWNrOjAuNy4wXG4gICAgcmVzdGFydDogdW5sZXNzLXN0b3BwZWRcbiAgICB2b2x1bWVzOlxuICAgICAgLSBkZWNrY2FjaGU6L2RhdGFcblxuICBnb3RlbmJlcmc6XG4gICAgaW1hZ2U6IGdvdGVuYmVyZy9nb3RlbmJlcmc6OFxuICAgIHJlc3RhcnQ6IHVubGVzcy1zdG9wcGVkXG5cbnZvbHVtZXM6XG4gIHBnZGF0YTpcbiAgZGVja2NhY2hlOlxuICBjYWRkeS1kYXRhOlxuICBjYWRkeS1jb25maWc6XG4iLAogICJjb25maWciOiAiW3ZhcmlhYmxlc11cbm1haW5fZG9tYWluID0gXCIke2RvbWFpbn1cIlxucGdfcGFzc3dvcmQgPSBcIiR7cGFzc3dvcmQ6MzJ9XCJcbnNoYXJlX3NlY3JldCA9IFwiJHtwYXNzd29yZDo2NH1cIlxuYXBpX2tleV9zZWNyZXQgPSBcIiR7cGFzc3dvcmQ6NjR9XCJcblxuW2NvbmZpZ11cbmVudiA9IFtcbiAgXCJURUxBX1BVQkxJQ19CQVNFX1VSTD1odHRwczovLyR7bWFpbl9kb21haW59XCIsXG4gIFwiVEVMQV9QR19QQVNTV09SRD0ke3BnX3Bhc3N3b3JkfVwiLFxuICBcIlRFTEFfU0hBUkVfU0VDUkVUPSR7c2hhcmVfc2VjcmV0fVwiLFxuICBcIlRFTEFfQVBJX0tFWV9TRUNSRVQ9JHthcGlfa2V5X3NlY3JldH1cIixcbl1cblxuW1tjb25maWcuZG9tYWluc11dXG5zZXJ2aWNlTmFtZSA9IFwicHJveHlcIlxucG9ydCA9IDgwXG5ob3N0ID0gXCIke21haW5fZG9tYWlufVwiXG4iCn0=

Configuration

Base64

Links

Tags

On this page