Using only the dotfiles

Set up the desktop on an existing installation: scope and requirements.

On this page

Dotfiles instead of a new installation

The dotfiles are meant for an existing, compatible Linux system. They do not set up a complete operating system and do not replace missing packages. The download page provides a separate portable source archive with checksums. Start with its README for prerequisites and the package build steps.

What belongs to the desktop

The source tree contains the Hyprland Lua configuration, Quickshell QML files, neutral defaults and helper tools. For the full feature set you also need the adapted Hyprland plugins, the window switcher and the native terminal module.

Check before you set it up

  • Hyprland, Quickshell, Qt and qtermwidget must match the source version you use.
  • Native plugins and modules must be built against the actual target packages.
  • Back up your existing configuration and personal data first.
  • Check your own monitor, input and theme settings instead of taking over someone else's user state.
  • Use the released accompanying notes and the package dependencies; an unpacked archive alone does not install any dependencies.

What is included

The 0.1.0-18 archive contains desktop sources, separate neutral defaults, packaging recipes, native build tools and license notices. It contains no personal host settings, histories, credentials or compiled plugins. Build native components against the packages on your own machine.

This is a source export for experienced users. Installing this standalone archive on other systems was not separately smoke-tested. The live ISO is the recommended starting point.

If you have already installed the desktop as a matching package set, you can set up the signed update channel once. Its ABI requirements must match your system. The 0.1.0-18 source export is unchanged.

As of 9 November 2026 · This help describes version 0.1.0-27. Individual features and labels may change.

← More help topicsReport a problem →