Manage App Lists

An App List is a reusable set of applications. A Blueprint does not list apps itself: it selects one or more App Lists, and every computer that follows the Blueprint gets the apps of those lists. Edit a list once and every Blueprint that uses it receives the change with its next deploy.

Create an App List

1. Open Configuration > App Lists and select New App List.
2. Give it a purpose-based name, such as “Office tools” or “Science lab.” Optionally start from an existing list to copy its apps.
3. Search the app catalog and select Add for each app. The catalog shows human names, versions, and whether an app is ready under your organization’s software-delivery settings.
4. Select Save. Nothing reaches a computer until a Blueprint that selects this list is deployed.

Every organization starts with the built-in Essentials list. Edit it freely; it cannot be deleted.

Use a list in a Blueprint

1. Open the Blueprint and, under Apps, tick the lists it should install. The apps these computers get are shown beneath the lists.
2. Select Save draft or Prepare release as usual. The prepared version records the exact list versions it was built from.
3. Open a list from the Blueprint with Open to change its apps.
4. Which of the desktop’s own bundled apps stay installed is chosen on the Blueprint itself — see Desktop apps.

Save and deploy a list

Saving a list creates a new version of it and prepares a new candidate for every released Blueprint that uses the list. Computers do not change. Select Save & Deploy to also create the approval plan for each of those Blueprints on the Deploy page, exactly as a Policy change does. The Used by panel names every Blueprint that follows the list.

A list can be deleted only while no Blueprint uses it and no shipped Blueprint version was built from it.

Importing from a computer

When you import a computer into a Blueprint, its recognized applications are saved as an App List named after the Blueprint (“… · captured apps”) and selected by that Blueprint. For a managed reference computer, Cybex combines the applications in its deployed Blueprint with user Nix-profile and mapped Flatpak installs; that result is complete, so a later import can also remove an application that you removed on the computer. Apps already supplied by another selected App List are not duplicated. An unmanaged NixOS computer has no comparison baseline: matched packages are added, unresolved package names appear under Not imported, and the result is never treated as authoritative. Review and trim the captured list like any other.