Skip to main content

Manage Omarchy OS Devices with Swif Linux MDM

Overview

Omarchy is an opinionated, developer-focused Linux distribution built on Arch Linux, Hyprland, and Quickshell. It combines a fast keyboard-driven desktop with a curated development environment, coordinated system updates, security-focused defaults, and built-in access to modern AI coding agents.

Swif Linux MDM extends these device-level capabilities with centralized visibility and governance. Organizations can enroll company-owned or personally owned Omarchy devices, maintain an inventory of their Linux fleet, deploy organization-approved software, apply compatible security controls, and monitor the use of AI agents from the same platform used to manage other operating systems.

Swif has validated enrollment and selected management capabilities on Omarchy 4.0.2 for x86_64 devices. Because Omarchy uses Arch Linux, Hyprland, Quickshell, and its own coordinated update workflow, not every generic Linux policy is currently compatible. Review the compatibility section in this article and test every policy on a pilot device before production deployment.

Arm64 not yet supported by Omarchy but we will support it when it is supported.

Why organizations choose Omarchy

Omarchy is designed to give developers a complete working environment without requiring them to assemble and maintain a Linux desktop from individual components.

A productive environment from the first login

Omarchy includes a carefully integrated terminal-oriented workflow, a tiling window manager, development tools, browsers, productivity applications, and a consistent keyboard-driven interface. This reduces the time developers spend configuring a new workstation and makes it easier to establish a repeatable starting point.

The system is based on:

  • Arch Linux, providing access to a current package ecosystem.

  • Hyprland, providing a responsive tiling window-management experience.

  • Quickshell, which powers Omarchy's integrated desktop shell and panels.

  • A curated collection of development, terminal, productivity, and creative applications.

See the Omarchy Manual for an overview of the operating system and included workflow.

Security-focused local defaults

Omarchy includes several useful protections by default:

  • Full-disk encryption using LUKS is mandatory on encrypted installations.

  • Incoming network traffic is blocked by default, with limited exceptions required by enabled services.

  • SSH is disabled until the user explicitly enables it.

  • Docker networking is configured to reduce accidental container exposure.

  • Omarchy packages and installation images are signed.

  • System snapshots are created during the Omarchy update process.

These defaults create a strong starting point for an individual workstation. See Security in the Omarchy Manual for the current implementation details.

Coordinated rolling updates with recovery options

Omarchy builds on Arch Linux's rolling-release model while providing a coordinated update process through omarchy update. The stable channel follows official Omarchy releases and uses a delayed package mirror to identify compatibility problems before they reach most users.

The update workflow installs Omarchy and system packages together, applies required migrations, updates configuration, and creates a snapshot before changes are made. If an update causes a problem, supported installations can boot and restore the earlier system snapshot.

See Updates and System snapshots in the Omarchy Manual.

Important: An Omarchy snapshot restores the root filesystem, not the user's /home directory. It is not a replacement for backing up user data.

AI agents as part of the developer experience

Omarchy treats AI coding agents as first-class development tools. It provides launchers and shortcuts for multiple agentic coding tools, including Claude Code, Codex, OpenCode, GitHub Copilot CLI, and others.

Some Omarchy agent shortcuts run tools in unattended or auto-approving modes. Omarchy can also temporarily enable passwordless sudo. These features are useful for experienced developers, but they increase the importance of knowing which agents are running, what tools they invoke, and which privileged actions they perform.

See AI in the Omarchy Manual for the current list of integrated tools and launch behavior.

Why Omarchy still needs MDM

Secure operating-system defaults protect one device. MDM provides the organizational layer required to manage an entire fleet.

Without centralized management, IT teams can struggle to answer basic operational and compliance questions:

  • Which employees are using Omarchy devices?

  • Which devices are online, encrypted, current, or out of compliance?

  • Are required security controls still present after users customize their systems?

  • Which removable devices, applications, browser extensions, and services are in use?

  • Can IT distribute and maintain required internal or third-party software consistently?

  • Can IT respond when a device is lost or an employee leaves?

  • Which AI agents are running, and what tools or commands are they using?

  • Can the organization produce consistent evidence for an audit?

Swif Linux MDM adds centralized inventory, device ownership records, compliance visibility, compatible policy enforcement, custom software deployment, remote administration, and reporting. Swif Agentic Security adds a separate control layer for monitoring AI-agent activity.

This combination lets developers retain the productivity and flexibility of Omarchy while giving IT and security teams the visibility required to manage company data and access responsibly.

Validated Swif capabilities on Omarchy

Swif tested the following configuration:

Item

Validated configuration

Omarchy version

4.0.2

Processor architecture

x86_64

Swif Linux enrollment

Working

Swif Agentic Security installation

Working

The following policies were also validated successfully:

Capability

Status

Notes

Linux Tracking Policy

Validated

Policy installation and operation were confirmed during testing.

Agentic Security

Validated

The separate Agentic Security agent installed and connected successfully.

OpenClaw Logging Policy

Validated

OpenClaw activity logging was successfully enabled.

OpenClaw Tools Experimental Policy

Validated

The policy applied successfully in the tested configuration.

OpenClaw Tools Runtime Policy

Validated

The policy applied successfully in the tested configuration.

Validation applies to the tested Omarchy version and architecture. A future Omarchy, Arch, desktop-shell, or Swif update can change compatibility. Test on a representative pilot group before expanding deployment.

Policies with limitations or pending validation

Omarchy is Arch-based and uses a desktop stack that differs from GNOME, KDE, XFCE, MATE, and Cinnamon. Policies that depend on a particular package name, login manager, desktop settings database, or distribution-specific update command may not work without an Omarchy-specific implementation.

Policy or capability

Current status

Guidance

Linux SSHD Policy

Known issue

Testing failed because the required application could not be located through the package-manager workflow. Do not assign this policy to production Omarchy devices.

Linux Screen Saver Policy

Not currently validated

The existing policy targets supported settings in GNOME, XFCE, MATE, and Cinnamon. Omarchy uses Hyprland and Quickshell. Use Omarchy's native idle and lock settings until Swif confirms compatibility.

Linux Google Login and Azure Login policies

Not currently validated

These authentication workflows may depend on distributions, display managers, or PAM configurations that differ from Omarchy. Test login and recovery carefully before deployment.

Linux Home Encryption Policy

Testing in progress

Omarchy already uses LUKS full-disk encryption on encrypted installations. A separate home-directory encryption policy may be redundant or incompatible. Do not test encryption changes without a recovery plan and current backup.

Linux Password Policy

Testing in progress

The policy modifies local password and PAM behavior. Validate login, sudo, lock-screen, and recovery behavior on a disposable pilot device first.

Linux Software Update Policy

Not currently validated

Omarchy protects its coordinated update path and directs administrators to use omarchy update. Do not deploy a generic package update policy until Swif confirms it preserves Omarchy snapshots, migrations, and configuration updates.

Other Linux policies

Validate before production use

Compatibility should not be inferred only because a policy supports another Arch-based or systemd-based distribution.

For the complete Linux policy catalog, see List of Linux Policies. The Omarchy-specific status in this article takes precedence when a policy has not yet been validated on Omarchy.

Requirements

Before enrolling an Omarchy device, confirm the following:

  • Omarchy is installed and functioning normally.

  • The tested configuration is Omarchy 4.0.2 on an x86_64 device.

  • The device can reach the internet and Swif services.

  • You have a Swif administrator account.

  • You have local sudo access to the device.

  • Important user data is backed up.

  • You have decided whether the device will be company-owned or BYOD.

  • You have selected a pilot device that can be recovered if a policy causes a login, encryption, networking, or desktop problem.

Swif may work on later Omarchy releases or other architectures, but treat configurations outside the validated environment as untested until your organization confirms them.


Enroll an Omarchy device in Swif

Omarchy uses the standard Swif Linux enrollment workflow.

1. Generate the enrollment installer or command

  1. Sign in to the Swif Admin Console.

  2. Go to Device Management > Device Inventory.

  3. Select Add Devices.

  4. Select Linux.

  5. Choose an installation method:

    • Application Installer to download the installer.

    • Command Line to generate an installation script.

  6. Select x86_64 for the validated Omarchy configuration.

  7. Select Company-Owned or BYOD, as appropriate.

  8. Configure the enrollment code options when required.

Always copy the current installer or command from your own Swif console. Do not reuse an old installer URL or sample command because the agent version and organization parameters may have changed.

2. Run the enrollment on Omarchy

  1. Open a terminal on the Omarchy device.

  2. Run the complete command generated by Swif, or make the downloaded installer executable and run it.

  3. Approve the sudo prompt.

  4. Enter the enrollment code if prompted.

  5. Allow the installer to download its dependencies, install the Swif agent, and complete registration.

3. Confirm the Swif agent

On the device, run:

systemctl status swif-agent

Confirm that the service is active. Then return to Device Management > Device Inventory and verify that the device appears online or enrolled.

For the complete enrollment workflow and architecture troubleshooting, see Enroll Linux Devices.

Deploy organization-approved software

Swif's custom software workflow can distribute internal tools, security agents, developer utilities, and other organization-approved software to enrolled Linux devices. Swif supports Linux package definitions that use ARCH packages, PACMAN, external repositories, ZIP archives, and TAR archives, in addition to formats and package managers for other Linux distributions.

For Omarchy, select an Arch-compatible package and the matching architecture. Do not assign DEB or RPM packages to Omarchy devices.

To add custom software:

  1. In the Swif Admin Console, go to Device Management > Applications.

  2. Select Add Custom Application.

  3. Add the application details and an Omarchy-compatible Linux package.

  4. Configure any required pre-install, post-install, validation, and uninstall scripts.

  5. Assign the application to a pilot Omarchy device or device group.

  6. Confirm the installation and application behavior before expanding the assignment.

Use an installation validation rule so Swif can distinguish a successful installation from a package that was only assigned. Linux custom software can be validated by an expected file path, a file hash, or an install-check script. Software-deployment scripts run with elevated permissions, so review them as privileged code and restrict write locations and downloaded content appropriately.

If you deploy a TAR archive, include a Makefile with an install target or provide a pre-install script that downloads and installs the archive. Merely reproducing an absolute directory structure inside the archive does not copy its contents into those system locations.

Important: Custom software deployment has not been included in the current Omarchy 4.0.2 validation set. Test installation, detection, upgrade, and removal on a recoverable pilot device. Do not use a custom application package to replace Omarchy's coordinated omarchy update process.

For supported Linux formats, repository options, validation rules, scripts, and deployment instructions, see Installing Custom Software via Swif.

Enable Agentic Security on Omarchy

The Agentic Security agent is separate from the Swif MDM agent. Installing the MDM agent does not automatically install Agentic Security.

To enable Agentic Security:

  1. Enroll the Omarchy device in Swif Linux MDM.

  2. In Swif, open the Agentic Security setup experience.

  3. Download the Linux Agentic Security installer.

  4. Make the installer executable and run it with the required organization and user parameters.

  5. Confirm that the device appears in the Agentic Security device list.

  6. Assign the required OpenClaw policies.

  7. Generate controlled test activity and verify that it appears in Swif.

The following OpenClaw policies have been validated on Omarchy 4.0.2 x86_64:

  • OpenClaw Logging

  • OpenClaw Tools Experimental

  • OpenClaw Tools Runtime

For setup and policy instructions, see Getting Started with Swif's Agentic Security for Enterprise.


Recommended deployment plan

Start with visibility

Enroll a small number of devices and confirm:

  • Device ownership and user assignment are correct.

  • Hardware and operating-system inventory is reported.

  • The Swif agent remains online after restart and after an Omarchy update.

  • Required compliance evidence appears in Swif.

  • The Linux Tracking Policy behaves as expected.

Add Agentic Security

For developers using AI agents:

  1. Install the Agentic Security agent.

  2. Start with logging and audit visibility.

  3. Review the tools and commands used during normal development work.

  4. Apply more restrictive controls only after measuring the effect on legitimate workflows.

This staged approach is particularly important on Omarchy because AI tools can be launched in unattended modes and developers may intentionally grant temporary elevated access.

Validate each additional policy

Do not assign every Linux policy at once. Add one policy at a time and test:

  • Login and sudo access

  • Screen locking and session recovery

  • Network connectivity

  • Omarchy updates and snapshots

  • LUKS unlock and recovery

  • Hyprland and Quickshell startup

  • Developer tools and containers

  • Swif agent connectivity after restart

Maintain an out-of-band recovery method and a current backup while testing authentication, encryption, networking, or firewall policies.


Operational considerations

Preserve the Omarchy update workflow

Omarchy warns against using direct pacman -Syu or yay -Syu updates because those commands can bypass Omarchy's snapshots, migrations, and configuration updates. Use the supported omarchy update workflow until Swif releases and validates an Omarchy-aware update policy.

Treat desktop-specific policies carefully

Omarchy does not use the desktop stacks targeted by many traditional Linux management scripts. A policy can install successfully at the agent level but still fail to change Hyprland or Quickshell behavior. Verify the resulting configuration on the device rather than relying only on a generic installation status.

Avoid duplicate encryption controls

Omarchy's standard encrypted installation uses LUKS full-disk encryption. Do not assume that adding home-directory encryption improves the security of every deployment. Layering encryption mechanisms can complicate login, recovery, performance, and support.

First confirm the organization's requirement, the existing disk layout, available recovery material, and the behavior of the proposed policy on a disposable device.

Manage third-party and AI code as an organizational risk

Omarchy offers extensive customization and AI-agent integration. Third-party shell plugins can run unsandboxed inside the Omarchy shell, and AI agents may execute commands with broad user or temporary root privileges.

Organizations should combine:

  • Approved software and plugin guidance

  • Least-privilege access

  • Controlled sudo permissions

  • AI-agent logging

  • Tool-use review

  • Device inventory and compliance monitoring

  • A documented incident and offboarding process

Omarchy provides a productive endpoint. Swif provides the centralized governance needed to operate those endpoints across an organization.


Troubleshooting

The device does not appear in Swif

Confirm the architecture:

uname -m

For the validated configuration, the result should be:

x86_64

Check the Swif service:

systemctl status swif-agent
  1. Confirm that the device can reach Swif services.

  2. Verify that the installer was generated for the correct organization and ownership mode.

  3. Re-run the current installer from the Swif console if installation ended early.

A policy reports an application or package-manager error

Omarchy uses Arch packages and the pacman ecosystem, but it also wraps some system functions in Omarchy-specific commands and menus. A policy written for another distribution may search for a package name or management interface that Omarchy does not expose in the same way.

Remove the policy from the pilot device, collect the policy execution report, and contact Swif Support. Do not repeatedly deploy the failed policy across the production fleet.

The Linux SSHD Policy fails

The Linux SSHD Policy is not currently validated on Omarchy. Initial testing failed because the expected application could not be found through the policy's package-manager workflow.

Until compatibility is added, use Omarchy's native Setup > Security > SSHD control when SSH is required. Omarchy keeps SSH disabled by default and opens port 22 with rate limiting when the feature is enabled.

The Screen Saver Policy does not change the lock behavior

The existing Linux Screen Saver Policy targets other supported desktop environments. Omarchy uses Hyprland and Quickshell, with its own idle and locking configuration. Do not assume the policy controls the Omarchy session until Swif confirms support.

Omarchy updating and Swif policy behavior conflict

Stop the deployment and restore the pilot device to a known-good state. Use omarchy update for system updates and review whether the Swif policy attempted to call pacman, yay, or another package-manager command directly.

If necessary, use an Omarchy system snapshot to restore the root filesystem. Remember that snapshots do not restore /home.

MDM works but Agentic Security data is missing

Confirm that:

  • The Agentic Security agent was installed separately.

  • The device appears in the Agentic Security inventory.

  • An OpenClaw logging policy is assigned.

  • The policy reports as installed.

  • Test activity was generated after the policy became active.

  • The device is online and can reach Swif services.


Frequently asked questions

Is Omarchy officially supported by Swif?

Swif has validated Linux MDM enrollment, the Linux Tracking Policy, the Agentic Security agent, and selected OpenClaw policies on Omarchy 4.0.2 x86_64. Other policies require individual validation. Refer to the compatibility tables in this article before deployment.

Can I enroll a personal Omarchy device?

Yes. Swif supports Linux BYOD enrollment, including a read-only mode for organizations that need inventory visibility without policy enforcement or remote commands.

Does Swif replace Omarchy's built-in security?

No. Omarchy provides local operating-system protections and a curated desktop environment. Swif adds centralized inventory, management, compliance visibility, remote administration, and AI-agent governance across the fleet.

Should I use Swif to update Omarchy?

Not until an Omarchy-aware update workflow has been validated. Continue using omarchy update so that package updates, Omarchy migrations, configuration changes, and snapshots occur together.

Does the Linux Home Encryption Policy improve an encrypted Omarchy installation?

Not necessarily. Omarchy already uses LUKS full-disk encryption on encrypted installations. Additional home-directory encryption can introduce complexity without satisfying a new security requirement. Wait for compatibility testing and review your organization's threat model before adding another encryption layer.

Why is Agentic Security especially relevant to Omarchy?

Omarchy makes autonomous coding agents easy to launch and can run them in unattended modes. Swif Agentic Security provides organizational visibility into supported agent activity and tool use, helping security teams govern this new class of endpoint behavior without removing the developer workflow that makes Omarchy valuable.

Summary

Omarchy gives developers a fast, cohesive, security-conscious Linux workstation with excellent support for modern development and AI-assisted workflows. Swif Linux MDM adds the fleet-level controls that a local operating system cannot provide by itself.

For the validated Omarchy 4.0.2 x86_64 configuration, organizations can:

  • Enroll the device in Swif Linux MDM.

  • Maintain centralized device visibility.

  • Pilot the deployment of Arch-compatible custom software.

  • Apply the validated Linux Tracking Policy.

  • Install Swif Agentic Security.

  • Apply the validated OpenClaw Logging, Tools Experimental, and Tools Runtime policies.

Deploy additional Linux policies only after Omarchy-specific testing. Pay particular attention to desktop, authentication, encryption, SSH, and software-update policies because Omarchy's architecture and workflows differ from more traditional Linux distributions.

Related resources

Did this answer your question?