Skip to main content

CatOS Hello

CatOS Hello is the graphical welcome and maintenance application shipped by CatOS. When the catos-hello package is installed, open CatOS Hello from the application menu or launch it in a terminal:

catos-hello

It detects whether it is running in the Live installation environment or on an installed system, then presents the relevant actions.

In a Live session​

The welcome page offers Install CatOS and Advanced installer. The advanced path lets you choose network installation configuration and additional packages. Before installing, you can also access the disk and recovery tools to open a partition editor or terminal, or inspect installation logs.

See the installation overview for installation modes and disk preparation.

On an installed system​

The main navigation includes:

PageWhat it provides
HomeSystem and desktop information, and onboarding actions
Software and desktopGraphical package-management entry points and Catdot Profile listing, preview, and switching
System maintenancePackage mirror selection, repository configuration, failed service checks, Pacman logs, and diagnostic log collection
About CatOSDistribution information and project links

You can also manage packages directly through Shelly or Pacman. Do not start package transactions simultaneously from multiple frontends.

Preview and switch a desktop Profile​

On Software and desktop, select a Catdot Profile and choose Review and switch Profile:

  1. Hello asks Catdot for a preview showing required packages, configuration files to be added or removed, and affected existing paths.
  2. Only after you confirm does Catdot perform activation.
  3. Switching a complete desktop Profile normally requires signing out and back in.

Previewing does not write files or install packages. Catdot backs up existing content before replacing it during activation, but these backups are not full system snapshots. If Catdot is not installed or no Profiles are available, the desktop section may only show an explanation.

The equivalent terminal commands are:

catdot list
catdot plan catos-niri-dms
catdot select catos-niri-dms

See the Catdot Profile guide for details.

Maintenance and diagnostic tools​

CatOS Hello provides mirror selection, repository editing, failed service inspection, Pacman transaction history, and diagnostic log collection. Some actions open external tools or a terminal and may require administrator authorization. Review each operation before confirming a system change.

For rolling updates, package signatures, and recovery, see Updating the system and System maintenance.