Skip to content

Getting started

Architecture

Hedlo is made of separate apps that share code but never share a process. That keeps a customer session away from staff pages and lets you scale or restart each part on its own.

Apps and ports

AppDefault portRole
Bolt admin3300Staff area for billing, support and setup
Bolt client3400Storefront and client area
Loom admin3100Staff panel, job worker, node enrollment
Loom client3200Customer panel
Loom API3300REST API (/api/v1, /api/client)
Shuttle8443 (API), 2022 (SFTP)Node daemon on each machine

Bolt and Loom both default to port 3300 for one app. When you run them on the same host, change one of them with its PORT setting.

From order to running server

  1. A customer orders in the Bolt storefront and pays an invoice.

  2. Bolt's provisioning module calls Loom with the plan's resources, location and server template.

  3. Loom picks a node in that location and asks its Shuttle daemon to create the container and allocate ports.

  4. Shuttle pulls the image, runs the template's install script and starts the server.

  5. The customer opens the Loom panel. The console, file manager and resource graphs stream live from Shuttle.

Renewals, suspensions and terminations follow the same path: Bolt decides, Loom applies, Shuttle executes.

Live updates

Every page is rendered on the server and stays connected. When data changes, for example a new ticket reply or a server that finishes installing, the server sends the change and the page updates without a reload. Pages still work without JavaScript; forms post normally.

Data and secrets

  • Bolt and Loom each use their own PostgreSQL database and run migrations when they start.

  • Node tokens, database passwords and integration secrets are encrypted at rest with a vault key that stays on your server.

  • Shuttle keeps server data in /var/lib/shuttle and never deletes it when the package is removed.

Trust between the parts

  • Shuttle enrolls with a one-time join token created in Loom, then authenticates every request with its own node credentials.

  • Bolt talks to Loom with a scoped API key.

  • Releases, plugins and themes are signed with Ed25519. Each app only loads code signed by a key you trust.