Skip to content

MIGRATION.md

Latest commit

 

History

History
52 lines (40 loc) · 2.05 KB

MIGRATION.md

File metadata and controls

52 lines (40 loc) · 2.05 KB
Raw

Moving a Try Omarchy setup to a real Omarchy install

Try Omarchy is disposable by design: deleting %LOCALAPPDATA%\TryOmarchy is the uninstall. If the trial wins you over, try-omarchy-export carries the parts worth keeping to a bare-metal Omarchy install.

Export inside Omarchy

Open a terminal (SUPER+RETURN) and run:

try-omarchy-export

It writes omarchy-export-<date>.tar.gz to the shared Windows folder when Try Omarchy was started with -share, otherwise to your home folder. Pass a directory to choose another place. The archive contains:

  • home/: an allowlist of Omarchy, Hyprland, terminal, bar, notification, input, and other desktop configuration; ~/.local/share/omarchy; ~/.local/bin; and shell dotfiles (.bashrc, .zshrc, .gitconfig, and friends).
  • theme: the name of the theme you had selected.
  • packages/repo.txt and packages/aur.txt: packages you added on top of the factory image, split by where they come from.
  • restore.sh and manifest.json.

Left out on purpose: unlisted application config, ~/.ssh, ~/.gnupg, password managers, browser profiles, and caches. Those either may hold secrets you should move yourself or are rebuilt on the new machine. The allowlist avoids common credential files under ~/.config, but the archive is still your data. Review it before sharing it with anyone.

Restore on the real install

Copy the archive over (USB stick, the shared folder, scp through the SSH preset), then as the user who should receive the configuration:

tar -xzf omarchy-export-<date>.tar.gz
cd omarchy-export-<date>
./restore.sh

The script backs up anything it replaces under ~/.omarchy-restore-backup/<time>, installs the repository packages with pacman and the AUR packages with yay, and selects your theme. Log out and back in afterwards so Hyprland and the shell pick up the restored configuration.

Packages that no longer exist, or themes you installed from a third-party repository, are reported at the end rather than stopping the restore. Review packages/*.txt if something is missing.