# How to Reset Omarchy Configurations to Defaults

> Easily reset Omarchy configurations to defaults with omarchy-refresh-config. This command backs up your settings and restores them to their original state.

- Repository: [Omacom/omarchy](https://github.com/omacom/omarchy)
- Tags: how-to-guide
- Published: 2026-09-02

---

**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`](https://github.com/omacom/omarchy/blob/main/manual/46-faq.md) and thoroughly tested in [`test/shell.d/refresh-config-test.sh`](https://github.com/omacom/omarchy/blob/main/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:

```bash
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:

```bash
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:**

```bash
omarchy-refresh-hyprland

```

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

**Reset tmux configuration:**

```bash
omarchy-refresh-tmux

```

**Reset the Omarchy shell menu:**

```bash
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:

```bash
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.