How to Reset Omarchy Configurations to Defaults

Run omarchy-refresh-config <path> to restore any Omarchy configuration file to its default state, automatically creating timestamped backups of your existing settings before overwriting.

Omarchy provides specialized helper binaries to safely revert your customized settings back to the pristine defaults shipped with the omacom/omarchy repository. Located in the bin/ directory, these utilities handle the restoration process while ensuring you never lose your previous configurations permanently.

How to Reset Omarchy Configurations

The configuration reset workflow centers on the omarchy-refresh-config command, which is documented in manual/46-faq.md and thoroughly tested in test/shell.d/refresh-config-test.sh. This command copies files from $OMARCHY_PATH/config/ to your local $HOME/.config/ directory.

Reset Individual Configuration Files

To restore a single file to its default state, specify its relative path within the config directory:

omarchy-refresh-config hypr/bindings.lua

The command first checks for an existing file at $HOME/.config/hypr/bindings.lua. If found, it creates a backup named bindings.lua.bak.<timestamp> before copying the pristine version from the repository.

Other common single-file resets include:

omarchy-refresh-config hypr/hyprland.lua
omarchy-refresh-config tmux/tmux.conf
omarchy-refresh-config omarchy/shell.json

Reset Entire Component Groups

For convenience, Omarchy includes wrapper scripts that reset entire configuration suites. These wrappers invoke the core refresh command for every file in a specific component.

Reset all Hyprland configurations:

omarchy-refresh-hyprland

This command, defined in bin/omarchy-refresh-hyprland, iterates through all Hyprland-related files in the repository config.

Reset tmux configuration:

omarchy-refresh-tmux

Reset the Omarchy shell menu:

omarchy-refresh-shell

Each wrapper script maintains the same backup safety protocols as the core utility.

How the Backup System Works

According to the source implementation in bin/omarchy-refresh-config, the reset process prioritizes data preservation. When a user-owned configuration exists at the target path, the utility automatically generates a timestamped backup using the pattern *.bak.<timestamp> before proceeding with the copy operation.

These backup files remain in your $HOME/.config/ directory alongside the restored defaults. To remove them after verifying your configuration works correctly:

find "$HOME/.config" -name '*.bak.*' -delete

Summary

• omarchy-refresh-config in bin/omarchy-refresh-config is the core utility that restores files from $OMARCHY_PATH/config/ to $HOME/.config/
• Component wrappers (omarchy-refresh-hyprland, omarchy-refresh-tmux, omarchy-refresh-shell) reset entire configuration groups with single commands
• Automatic timestamped backups are created before any overwrite, following the pattern <filename>.bak.<timestamp>
• Safety validation ensures requested paths exist in the repository's config directory before any file operations occur
• Cleanup of old backups can be performed safely once you confirm the default configuration functions as expected

Frequently Asked Questions

What is the omarchy-refresh-config command?

omarchy-refresh-config is a helper binary in the Omarchy repository that restores configuration files to their default state. It copies pristine files from $OMARCHY_PATH/config/ into your user's $HOME/.config/ directory, automatically backing up any existing files with timestamp extensions before overwriting them.

Will I lose my custom configurations when resetting Omarchy settings?

No, the reset process is non-destructive. Before overwriting any existing configuration file, omarchy-refresh-config creates a timestamped backup in the same directory. Your custom settings remain accessible in these .bak.<timestamp> files within your local config folder, allowing you to revert manually if needed.

How do I reset the entire Hyprland configuration to defaults?

Run the omarchy-refresh-hyprland command. This wrapper script invokes the core refresh utility for every Hyprland-related configuration file in the repository, effectively restoring the complete Hyprland component while creating backups of your current setup.

Can I undo a configuration reset after running the command?

Yes, you can manually restore your previous configuration from the automatic backup file created during the reset process. Locate the relevant .bak.<timestamp> file in your $HOME/.config/ directory and replace the current file with this backup version.

{
  "mcpServers": {
    "instagit": {
      "command": "npx",
      "args": ["-y", "instagit@latest"]
    }
  }
}