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, |
Linux Software Update Policy | Not currently validated | Omarchy protects its coordinated update path and directs administrators to use |
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
sudoaccess 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
Sign in to the Swif Admin Console.
Go to Device Management > Device Inventory.
Select Add Devices.
Select Linux.
Choose an installation method:
Application Installer to download the installer.
Command Line to generate an installation script.
Select x86_64 for the validated Omarchy configuration.
Select Company-Owned or BYOD, as appropriate.
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
Open a terminal on the Omarchy device.
Run the complete command generated by Swif, or make the downloaded installer executable and run it.
Approve the
sudoprompt.Enter the enrollment code if prompted.
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:
In the Swif Admin Console, go to Device Management > Applications.
Select Add Custom Application.
Add the application details and an Omarchy-compatible Linux package.
Configure any required pre-install, post-install, validation, and uninstall scripts.
Assign the application to a pilot Omarchy device or device group.
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:
Enroll the Omarchy device in Swif Linux MDM.
In Swif, open the Agentic Security setup experience.
Download the Linux Agentic Security installer.
Make the installer executable and run it with the required organization and user parameters.
Confirm that the device appears in the Agentic Security device list.
Assign the required OpenClaw policies.
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:
Install the Agentic Security agent.
Start with logging and audit visibility.
Review the tools and commands used during normal development work.
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
sudoaccessScreen 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
sudopermissionsAI-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
Confirm that the device can reach Swif services.
Verify that the installer was generated for the correct organization and ownership mode.
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.