# tritondatacenter/triton architecture

> Architecture diagram of the GitHub repository tritondatacenter/triton, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-26). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/tritondatacenter/triton
- Repository: https://github.com/tritondatacenter/triton

## Overview

This repository is an overview and documentation index for Triton, not the implementation of its services. The graph summarizes the documented product workflow and major capabilities; service-to-service wiring is limited to what the README explicitly supports.

Main entry points: [`docs/developer-guide`](https://github.com/tritondatacenter/triton/tree/master/docs/developer-guide) (USB / ISO / iPXE), [`docs/developer-guide/architecture.md`](https://github.com/tritondatacenter/triton/blob/master/docs/developer-guide/architecture.md) (Architecture guide), [`docs/reference.md`](https://github.com/tritondatacenter/triton/blob/master/docs/reference.md) (Component reference)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interfaces["User interfaces"]
  node_cli["CLI tooling"]
  node_portal["Operator portal"]
  node_public_api["Public API"]
end

subgraph group_control["Control plane"]
  node_private_apis["Private APIs"]
  node_services["Core services"]
end

subgraph group_compute["Compute fabric"]
  node_agents["Compute agents"]
  node_smartos["SmartOS zones"]
  node_instances["Instances"]
end

subgraph group_deployment["Deployment"]
  node_installer["USB / ISO / iPXE"]
  node_headnode["Head node"]
  node_compute_nodes["Compute nodes"]
end

node_operator(("Operator"))
node_customer(("Cloud user"))
node_architecture_docs["Architecture guide<br/>[architecture.md]"]
node_reference_docs["Component reference<br/>[reference.md]"]

node_operator -->|"installs via"| node_installer
node_installer -->|"installs"| node_headnode
node_headnode -->|"hosts core"| node_services
node_headnode -->|"manages"| node_compute_nodes
node_compute_nodes -->|"runs"| node_agents
node_compute_nodes -->|"runs"| node_smartos
node_customer -->|"uses"| node_cli
node_customer -->|"requests"| node_public_api
node_operator -->|"uses"| node_portal
node_cli -->|"calls"| node_public_api
node_portal -->|"uses"| node_public_api
node_public_api -->|"manages through"| node_private_apis
node_private_apis -->|"uses"| node_services
node_services -->|"manages"| node_agents
node_agents -->|"manage and monitor"| node_smartos
node_smartos -->|"hosts"| node_instances
node_architecture_docs -.->|"describes"| node_services
node_reference_docs -.->|"documents"| node_private_apis

click node_installer "https://github.com/tritondatacenter/triton/tree/master/docs/developer-guide"
click node_architecture_docs "https://github.com/tritondatacenter/triton/blob/master/docs/developer-guide/architecture.md"
click node_reference_docs "https://github.com/tritondatacenter/triton/blob/master/docs/reference.md"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_cli,node_portal,node_public_api,node_customer toneBlue
class node_private_apis,node_services toneAmber
class node_agents,node_smartos,node_instances toneMint
class node_installer,node_headnode,node_compute_nodes toneRose
class node_operator toneIndigo
class node_architecture_docs,node_reference_docs toneTeal
```

## Components

### User interfaces

- **CLI tooling**
- **Operator portal**
- **Public API**

### Control plane

- **Private APIs**
- **Core services**

### Compute fabric

- **Compute agents**
- **SmartOS zones**
- **Instances**

### Deployment

- [USB / ISO / iPXE](https://github.com/tritondatacenter/triton/tree/master/docs/developer-guide): `docs/developer-guide`
- **Head node**
- **Compute nodes**

### Other components

- **Operator**
- **Cloud user**
- [Architecture guide](https://github.com/tritondatacenter/triton/blob/master/docs/developer-guide/architecture.md): `docs/developer-guide/architecture.md`
- [Component reference](https://github.com/tritondatacenter/triton/blob/master/docs/reference.md): `docs/reference.md`

## Connections

- Operator → USB / ISO / iPXE: installs via
- USB / ISO / iPXE → Head node: installs
- Head node → Core services: hosts core
- Head node → Compute nodes: manages
- Compute nodes → Compute agents: runs
- Compute nodes → SmartOS zones: runs
- Cloud user → CLI tooling: uses
- Cloud user → Public API: requests
- Operator → Operator portal: uses
- CLI tooling → Public API: calls
- Operator portal → Public API: uses
- Public API → Private APIs: manages through
- Private APIs → Core services: uses
- Core services → Compute agents: manages
- Compute agents → SmartOS zones: manage and monitor
- SmartOS zones → Instances: hosts
- Architecture guide → Core services: describes
- Component reference → Private APIs: documents