$ BLR//CODE

Home / Reference architectures

REF/ — Reference architectures

Designs we build from.

Starting points rather than templates. Each one is a shape we have implemented and operated, with the reasoning attached — including where it stops being the right answer.

ARC/01 — Network

Segmented small-office network.

Four segments and a default-deny policy between them. The design principle is that the weakest device on a network should not be able to set the security level of the whole business, which is exactly what a single flat subnet arranges.

Internet ISP · MULTI-WAN Firewall / UTM POLICY · NAT · IDS Core switch (L3) 802.1Q TRUNK Remote access WIREGUARD MESH Staff Workstations, printers VLAN 10 · 10.0.10.0/24 Guest Visitor Wi-Fi only VLAN 20 · 10.0.20.0/24 IoT / CCTV Cameras, NVR, sensors VLAN 30 · 10.0.30.0/24 Servers NAS, line-of-business apps VLAN 40 · 10.0.40.0/24 DEFAULT DENY BETWEEN SEGMENTS — EAST-WEST TRAFFIC PASSES ONLY WHERE POLICY ALLOWS IT Monitoring & alerting UPTIME CHECKS · HOST METRICS · FIRMWARE + PATCH STATE · ALERTS THAT REACH A HUMAN
Fig. 1 — Segmented small-office network

Why it's shaped this way

  • Guest never touches internal. Cheapest meaningful win available
  • IoT and CCTV are quarantined — unpatchable devices with no reason to initiate anything
  • Servers accept, never initiate. A compromised server shouldn't be able to scan the office
  • Monitoring spans everything, configured during the build rather than as a later phase

Where it stops fitting

  • Multiple floors or sites need routed distribution rather than one core switch
  • Legacy broadcast-dependent software may force compromises — establish this before the cutover
  • Above roughly 100 users, per-user policy starts to beat per-segment policy

Network architecture practice →

ARC/02 — Delivery

Push-based deploy across a network boundary.

The conventional pipeline has the server pull from the repository. That requires the repository to be reachable from the server — which, if your source of truth lives on a private network, means exposing it. Inverting the direction removes the requirement entirely.

PRIVATE NETWORK — NOT REACHABLE FROM THE INTERNET Commit push to main Checkout CI runner Build / pull container images Scan CRITICAL = stop Deploy over SSH ON FAILURE Alert a human SUCCESS IS SILENT Public server 22 / 80 / 443 ONLY THE PRIVATE SIDE INITIATES. THE PUBLIC SERVER NEVER CONNECTS INWARD — SO COMPROMISING IT YIELDS NO PATH BACK TO THE SOURCE OF TRUTH.
Fig. 2 — Push-based deploy pipeline across a network boundary

Why it's shaped this way

  • Nothing inbound is required. The private side initiates; compromising the public server yields no path back
  • The scan is a gate, not an annotation — it sits before deploy, so a critical finding stops the release
  • Notifications fire on failure only. Silence means success, so a message always warrants attention
  • Deploys never overwrite environment configuration, so secrets stay out of the repository

Where it stops fitting

  • Many target hosts — push does not fan out gracefully; that is where pull-based GitOps earns its keep
  • Cross-architecture builds need care about where images are built versus scanned
  • Zero-downtime requirements need a rolling strategy in front of this, not a restart

The engagement note →

ARC/03 — Resilience

3-2-1 backup with an immutable copy.

Three copies, two media, one off-site — plus the modern addition that decides whether you recover from ransomware: at least one copy that cannot be altered or deleted, even by someone holding valid credentials.

Live data Server, workstations, mailboxes, accounts DB COPY 1 Local backup NAS or backup appliance FAST RESTORE — RTO IN MINUTES COPY 2 · DIFFERENT MEDIA Off-site, immutable OBJECT LOCK — CANNOT BE ALTERED OR DELETED COPY 3 · OFF-SITE Offline rotated disk PHYSICALLY DISCONNECTED · OPTIONAL RANSOMWARE REACHES THIS FAR — IT ENCRYPTS WHAT IT CAN WRITE TO RECOVERY COMES FROM HERE RESTORE TEST QUARTERLY — A BACKUP NOBODY HAS RESTORED FROM IS AN ASSUMPTION, AND THE FAILURES ARE ALWAYS SILENT ONES.
Fig. 3 — 3-2-1 backup topology for a small office

Why it's shaped this way

  • Local copy for speed. Restoring 800 GB from cloud storage over an office line is a two-day outage
  • Immutable copy for the bad case — object lock costs almost nothing and is the difference between recovery and negotiation
  • Backup credentials separated from domain accounts, so one compromise doesn't reach both
  • Restore testing scheduled, because untested backups fail silently and always have

Where it stops fitting

  • Very low RPO requirements need continuous replication, not scheduled jobs
  • Databases need consistent snapshots — copying an open file produces something that will not restore
  • Data residency rules may constrain where the off-site copy can physically live

Backup & recovery →

CTA/ — Your environment

Want one of these adapted to your setup?

These are starting points. The useful version is the one that accounts for your building, your budget, and the legacy system nobody wants to talk about.

Start a conversation →