Introduction

The Blackwall is a multi-host modular NixOS network. It utilises multiple physical hosts to spread processing power, storage capabilities as well as logical segmentation1.

The original idea was a single device running everything, however I've since discovered NixOS' multi-host systems. By managing multiple hosts on a single nix configuration, it becomes infinitely easier to treat all hosts as if they're part of a single system and brings the NixOS experience much closer to hypervisors like Proxmox, without virtualisation.

1

Logical segmentation, in this instance means that different hosts are designed for different purposes. This could be a small desktop running networking software while an enterprise device runs NAS software.

Hosts

This page outlines the hosts within the Blackwall network. Each host serves a different purpose which allows for the most value to be extracted from a device.

This logic stems from the original idea. A Beelink ME Pro with an N150 processor was intended to be a well-rounded home server. However, where it attempted to be a jack-of-all-trades, it became a master of none.

HostnamePurposeHardware
cynosureControl and monitoring nodeBeelink ME Pro N150
izanagiData fortressEnterprise server
mikoshiReserved name for future hostTBD
sapphireReserved name for future hostTBD
kabukiReserved name for future hostTBD

[!TIP] Each hostname comes from the world of Cyberpunk 2077. The 'Blackwall' is a firewall intended to keep rogue AIs trapped in the old Internet. Mikoshi is a data fortress owned by Arasaka and Cynosure was Miltech's competitor. Izanagi is an access point to Mikoshi while the Black Sapphire is skyscraper within Dogtown.

Cynosure

Cynosure is the first device to be added to the Network and serves as the overseeing node. This is the device that runs the monitoring, control and security software.

It is run on a Beelink N150 ME Pro with 2x 1TB HDD drives installed as well as a single NVMe drive for the OS.

Izanagi

Izanagi is a proposed enterprise server running the majority of hard drives for the server.

[!WARNING] Izanagi is hypothetical and does not yet exist.

Architecture

This page details the architecture rules for the Blackwall server and all hosts involved.

Rules

  1. Every host will have a single NVMe drive reserved for the OS.
  2. Every password, API key or secret is to be stored via sops-nix.
  3. Endpoints are kept to the minimum and user access is only via a tailnet 1.
  4. All software is managed and configured decleratively via the NixOS Blackwall config.
  5. Changing which host runs what should be decided by which modules it inherits.
  6. Deny by default.
  7. Every host will broadcast logs and metrics to the Cynosure host.
1

A tailnet is a type of mesh VPN created by Tailscale or Headscale (the self-hosted Tailscale alternative).

Topology

NixOS

Security

Networking

Maintenance

This page details any routine actions that must be performed to maintain the server.

Monitoring

Storage

Drives

RAID1

Services

Monitoring

Prometheus - central scrape target for data exporters running on every subhost.

Archive

Hardware

Rack

Hosts

Networking

Notes

  • List all services from blackwall.cam software list
  • List any maintenance routines
  • S

list all services

list maintenance routines

security hardening and list all possible endpoints

list all archived content

gantt, sankey and treeview maybe


Rules

All hosts have at least one NVMe drive which runs the operating system for the host. Non-negotiable