>Tish
HomeDocs

Zectre Platform

Architecture and services of the Zectre Platform.

The Zectre Platform is a Nomad-inspired orchestration platform for running Tish native binaries. For full details, see the zectre-platform README (and zectre-cli README for the CLI).

Architecture

Clients (zectre, Web UI)
    ↓
Control Plane: zectre-api, zectre-scheduler, zectre-registry
    ↓
Workers: zectre-agent (one or more nodes)
    ↓
Proxy: zectre-proxy (ingress / load balancing)

Services

ServiceRole
zectre-apiREST API gateway (apps, auth, deployments, builds, etc.)
zectre-schedulerJob scheduling, allocation, deployment orchestration
zectre-agentRuns and supervises Tish binaries on worker nodes
zectre-proxyReverse proxy, dynamic routing, cold start handling
zectre-registryArtifact storage for compiled binaries
zectre-buildBuilds Tish source via zectre compile

Quick start

In zectre-platform:

just setup
just run-all

Custom domains

You can map your own domains (e.g. api.example.com) to an application’s latest deployment.

  1. Dashboard: Open your app → Domains tab → Add custom domain. Enter the domain and choose the target environment (e.g. production).

  2. API: POST /api/v1/apps/{id}/custom-domains with body { "domain": "api.example.com", "environment": "production" }.

  3. DNS: Point your domain’s DNS (A or CNAME) to the platform proxy. The proxy routes requests by the Host header.

Custom domains route to the promoted “latest” deployment for the chosen environment. The platform generates a default domain (e.g. myapp-default.tish.localhost); custom domains are in addition to that.

See also