This is the multi-page printable view of this section. Click here to print.

Return to the regular view of this page.

Root Lock by HeartSuite Overview

Core concepts and purpose of Root Lock by HeartSuite.

    Overview: Every attack does three things: run a program, access files, make a network connection. Root Lock by HeartSuite enforces default-deny on all three at the kernel, per program, including as root.

    Your SSH server and your web server both run as root. They still get different permissions because they are different programs.

    Kernel-level enforcement

    No program can execute without an allowlist entry. That entry also controls which files the program can read or write, and which network connections it can make.

    The Dashboard is the interface. After unattended initial setup, it shows the checklist and what is waiting for review.

    After initial setup

    Initial setup runs unattended on first boot of the Root Lock kernel, and again after a kernel update if new startup programs appear. The Dashboard appears when that chain is complete.

    ChecklistPurpose
    1. Program AllowlistingReview and approve programs that need to execute
    2. File Access AllowlistingReview and approve file read/write access for programs
    3. Internet Access AllowlistingReview and approve outbound internet connections
    4. Secure Script LaunchersConfigure interpreters for Python, Perl, PHP (if applicable)
    5. Alert SettingsSet up notification channels (email, syslog, webhook)
    6. LockdownActivate Lockdown — locked until the earlier checklist items are complete

    Reduced kernel footprint

    The security industry patches vulnerabilities one at a time. Root Lock removes the features attackers rely on — by design.

    Most malware escalates privilege by reaching for the same handful of kernel features: eBPF to hide processes, FUSE to redirect reads, overlay filesystems to shadow directories, userspace LSM frameworks (AppArmor, SMACK, Landlock) to pivot through, and unprivileged user namespaces to gain root without credentials.

    The Root Lock kernel is deliberately compiled without them. These primitives are the attack surface, path to root, and bypass vectors the allowlist model exists to close.

    A stock Ubuntu kernel ships with over 6,600 loadable modules. The Root Lock kernel ships with 13.

    Detection tools like Falco, Cilium Tetragon, and bpftrace watch these features. Root Lock removes them. See Kernel architecture.

    Shared-kernel container guests, local eBPF tooling, and rootless containers are not a fit by design. See Deployment Scenarios.

    Features

    1. Program Allowlist

    An allowlist entry says whether a program may execute, which files it may read or write, and which network connections it may make. The kernel requires that entry before the program is permitted to execute.

    The Dashboard presents three review queues:

    • Programs queue ([p]) — programs that executed during Setup Mode
    • File Access queue ([f]) — programs that read or wrote files during Setup Mode
    • Internet Access queue ([i]) — programs that made outbound connections during Setup Mode

    File access is approved as read or write. Write includes read. See Allowlisting Basics for how the queues group volume.

    2. Setup Mode and Lockdown

    • Setup Mode: The kernel logs program executions, file accesses, and network connections without blocking them. Use this mode to build the allowlist.
    • Lockdown: The kernel enforces the allowlist. Programs without an entry, or that exceed their permissions, are blocked.

    Activating Lockdown requires empty review queues, configured alerts, and an active subscription. Type YES (case-sensitive) to confirm.

    Once Lockdown is applied, the allowlist cannot change while the machine is running, including as root. YES starts a probe reboot; a second reboot applies the seal. [m] Maintenance is the path to make changes. See Lockdown.

    3. File backup and versioning

    Root Lock backs up files in designated directories on every write. The version manager can restore a version after encryption, deletion, or modification.

    Modern ransomware destroys backup systems before encrypting files — shadow copies and backup agents are typically the first targets. Root Lock’s backups are not permission-protected: under Lockdown, the kernel blocks write and delete to the backup directory (/.hs/b/) for every program except Root Lock backup tooling, including root.

    When an approved program is compromised, recovery starts from the write before the damage, not the last scheduled snapshot.

    4. Secure Script Launchers

    For Python, PHP, and Perl, Secure Script Launchers identify the script being executed so each script gets its own allowlist entry, the same as a compiled program.

    Two setup paths

    Cloud Path

    Pre-installed on AWS, Google Cloud, Azure, DigitalOcean, Linode, and other providers. The Dashboard appears on first login.

    Local Path

    Download from heartsecsuite.com, install, and boot the Root Lock kernel. Initial setup runs unattended. Once the Dashboard appears, Cloud Path and Local Path merge.

    Many hosts still install through Cloud Path or Local Path on each machine. Ansible, Terraform, and GitOps apply allowlist policy after that install — see Central Policy.

    Is Root Lock right for you?

    Root Lock fits production servers, closed appliances, regulated workstations, build and CI infrastructure, and AI agent sandboxes. Containers fit as OCI images built and run off-host. Shared-kernel container guests, local eBPF tooling, and rootless containers are not a fit by design: the kernel omits overlay filesystems, user namespaces, and the BPF syscall because those are the features attackers use to hide, shadow directories, and reach root. See Deployment Scenarios.

    If you already run Falco, AppArmor, gVisor, a Linux EDR agent, a SIEM, NDR, or a scanner, see How Root Lock Compares and Security as economics.

    Launch a pre-installed cloud instance or download the Local Path package from heartsecsuite.com. Getting Started covers the rest.