# mcfso/irix-node architecture

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

- Interactive diagram: https://gitdiagram.com/mcfso/irix-node
- Repository: https://github.com/mcfso/irix-node

## Overview

IriX Node Daemon is a local Go service that exposes an MCSManager-style HTTP API for the IriX client. The main workflow is client request → daemon HTTP routing and authentication → domain operation → response or streamed result. Its major branches include instance and process management, files and transfers, Docker/Bastille, cluster synchronization, accounts, and the encrypted vault. The graph reflects documented capabilities and sampled relationships; several subsystem internals were not excerpted, so their connections are omitted rather than inferred.

Main entry points: [`instance.go`](https://github.com/mcfso/irix-node/blob/main/instance.go) (API routing), [`container.go`](https://github.com/mcfso/irix-node/blob/main/container.go) (Container API), [`accounts.go`](https://github.com/mcfso/irix-node/blob/main/accounts.go) (Account store), [`http_server.go`](https://github.com/mcfso/irix-node/blob/main/http_server.go) (HTTP server)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["API and runtime"]
  node_http["HTTP server<br/>[http_server.go]"]
  node_daemon["Daemon runtime<br/>[daemon.go]"]
  node_routing["API routing<br/>[instance.go]"]
end

subgraph group_instances["Instance operations"]
  node_instances["Instances<br/>[instance.go]"]
  node_process["Process control<br/>[process.go]"]
  node_console["Console streams<br/>[console_ws.go]"]
  node_backups["Instance backups<br/>[backup.go]"]
end

subgraph group_platform["Host and containers"]
  node_containers["Container API<br/>[container.go]"]
  node_docker["Docker backend"]
  node_bastille["Bastille backend"]
  node_jdk["Java installer<br/>[jdk_install.go]"]
  node_frp["FRP integration<br/>[frp.go]"]
  node_sysinfo["System information<br/>[sysinfo.go]"]
end

subgraph group_security["Identity and vault"]
  node_accounts_api["Account API"]
  node_accounts[("Account store<br/>[accounts.go]")]
  node_vault_api["Vault API<br/>[vault_handlers.go]"]
  node_vault["Vault state<br/>[vault.go]"]
  node_vault_store[("Encrypted storage<br/>[vault_store.go]")]
end

subgraph group_coordination["Files and cluster"]
  node_files["File operations<br/>[files.go]"]
  node_transfers["Download services<br/>[download.go]"]
  node_cluster["Cluster sync<br/>[cluster.go]"]
end

node_client(("IriX client"))
node_sql[("SQL database")]
node_redis[("Redis cache")]

node_client -->|"calls API"| node_http
node_http -.->|"routes requests"| node_routing
node_routing -->|"dispatches"| node_instances
node_routing -->|"registers routes"| node_accounts_api
node_routing -->|"registers routes"| node_containers
node_routing -->|"registers routes"| node_cluster
node_instances -->|"starts process"| node_process
node_routing -->|"registers routes"| node_console
node_routing -->|"registers routes"| node_backups
node_accounts_api -->|"authenticates"| node_accounts
node_accounts -->|"persists data"| node_sql
node_accounts -->|"caches sessions"| node_redis
node_vault_api -->|"updates state"| node_vault
node_vault -.->|"uses storage"| node_vault_store
node_containers -.->|"uses backend"| node_docker
node_containers -.->|"uses backend"| node_bastille
node_cluster -->|"issues tickets"| node_transfers
node_routing -.->|"registers routes"| node_files

click node_http "https://github.com/mcfso/irix-node/blob/main/http_server.go"
click node_daemon "https://github.com/mcfso/irix-node/blob/main/daemon.go"
click node_routing "https://github.com/mcfso/irix-node/blob/main/instance.go"
click node_instances "https://github.com/mcfso/irix-node/blob/main/instance.go"
click node_process "https://github.com/mcfso/irix-node/blob/main/process.go"
click node_console "https://github.com/mcfso/irix-node/blob/main/console_ws.go"
click node_backups "https://github.com/mcfso/irix-node/blob/main/backup.go"
click node_files "https://github.com/mcfso/irix-node/blob/main/files.go"
click node_transfers "https://github.com/mcfso/irix-node/blob/main/download.go"
click node_cluster "https://github.com/mcfso/irix-node/blob/main/cluster.go"
click node_accounts_api "https://github.com/mcfso/irix-node/blob/main/accounts_handlers.go"
click node_accounts "https://github.com/mcfso/irix-node/blob/main/accounts.go"
click node_vault_api "https://github.com/mcfso/irix-node/blob/main/vault_handlers.go"
click node_vault "https://github.com/mcfso/irix-node/blob/main/vault.go"
click node_vault_store "https://github.com/mcfso/irix-node/blob/main/vault_store.go"
click node_containers "https://github.com/mcfso/irix-node/blob/main/container.go"
click node_docker "https://github.com/mcfso/irix-node/blob/main/container_docker.go"
click node_bastille "https://github.com/mcfso/irix-node/blob/main/container_bastille.go"
click node_jdk "https://github.com/mcfso/irix-node/blob/main/jdk_install.go"
click node_frp "https://github.com/mcfso/irix-node/blob/main/frp.go"
click node_sysinfo "https://github.com/mcfso/irix-node/blob/main/sysinfo.go"

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_http,node_daemon,node_routing,node_client toneBlue
class node_instances,node_process,node_console,node_backups,node_sql,node_redis toneAmber
class node_containers,node_docker,node_bastille,node_jdk,node_frp,node_sysinfo toneMint
class node_accounts_api,node_accounts,node_vault_api,node_vault,node_vault_store toneRose
class node_files,node_transfers,node_cluster toneIndigo
```

## Components

### API and runtime

- [HTTP server](https://github.com/mcfso/irix-node/blob/main/http_server.go): `http_server.go`
- [Daemon runtime](https://github.com/mcfso/irix-node/blob/main/daemon.go): `daemon.go`
- [API routing](https://github.com/mcfso/irix-node/blob/main/instance.go): `instance.go`

### Instance operations

- [Instances](https://github.com/mcfso/irix-node/blob/main/instance.go): `instance.go`
- [Process control](https://github.com/mcfso/irix-node/blob/main/process.go): `process.go`
- [Console streams](https://github.com/mcfso/irix-node/blob/main/console_ws.go): `console_ws.go`
- [Instance backups](https://github.com/mcfso/irix-node/blob/main/backup.go): `backup.go`

### Host and containers

- [Container API](https://github.com/mcfso/irix-node/blob/main/container.go): `container.go`
- [Docker backend](https://github.com/mcfso/irix-node/blob/main/container_docker.go): `container_docker.go`
- [Bastille backend](https://github.com/mcfso/irix-node/blob/main/container_bastille.go): `container_bastille.go`
- [Java installer](https://github.com/mcfso/irix-node/blob/main/jdk_install.go): `jdk_install.go`
- [FRP integration](https://github.com/mcfso/irix-node/blob/main/frp.go): `frp.go`
- [System information](https://github.com/mcfso/irix-node/blob/main/sysinfo.go): `sysinfo.go`

### Identity and vault

- [Account API](https://github.com/mcfso/irix-node/blob/main/accounts_handlers.go): `accounts_handlers.go`
- [Account store](https://github.com/mcfso/irix-node/blob/main/accounts.go): `accounts.go`
- [Vault API](https://github.com/mcfso/irix-node/blob/main/vault_handlers.go): `vault_handlers.go`
- [Vault state](https://github.com/mcfso/irix-node/blob/main/vault.go): `vault.go`
- [Encrypted storage](https://github.com/mcfso/irix-node/blob/main/vault_store.go): `vault_store.go`

### Files and cluster

- [File operations](https://github.com/mcfso/irix-node/blob/main/files.go): `files.go`
- [Download services](https://github.com/mcfso/irix-node/blob/main/download.go): `download.go`
- [Cluster sync](https://github.com/mcfso/irix-node/blob/main/cluster.go): `cluster.go`

### Other components

- **IriX client**
- **SQL database**
- **Redis cache**

## Connections

- IriX client → HTTP server: calls API
- HTTP server → API routing: routes requests
- API routing → Instances: dispatches (evidence: `instance.go`)
- API routing → Account API: registers routes (evidence: `instance.go`)
- API routing → Container API: registers routes (evidence: `instance.go`)
- API routing → Cluster sync: registers routes (evidence: `instance.go`)
- Instances → Process control: starts process (evidence: `instance.go`)
- API routing → Console streams: registers routes (evidence: `instance.go`)
- API routing → Instance backups: registers routes (evidence: `instance.go`)
- Account API → Account store: authenticates (evidence: `accounts_handlers.go`)
- Account store → SQL database: persists data (evidence: `accounts.go`)
- Account store → Redis cache: caches sessions (evidence: `accounts.go`)
- Vault API → Vault state: updates state (evidence: `vault_handlers.go`)
- Vault state → Encrypted storage: uses storage
- Container API → Docker backend: uses backend
- Container API → Bastille backend: uses backend
- Cluster sync → Download services: issues tickets (evidence: `cluster.go`)
- API routing → File operations: registers routes
