joseivanlopez / agama-desktop-selection.md

Last active March 26, 2026 06:59

RFC: Desktop Environment Selection Mechanism

1. Abstract

This document proposes a mechanism for Desktop Environment (DE) selection within Agama. By introducing a selection strategy in the product metadata and enhancing the visibility of DE-related patterns, we aim to prevent accidental "text-mode" installations and improve the user onboarding experience.

2. Motivation

Currently, Agama does not guide the user about the desktop selection. Selecting a desktop is easily overlooked, ending with an installed system which starts in text-mode. As a primary installation decision, the selection of the desktop should be visually prominent and easily accessible.

joseivanlopez / agama-zfcp-api-v2.md

Last active February 23, 2026 13:08

System

{
  zfcp: {
    allowLunScan: true,
    controllers: [
      {
        channel: "0.0.0100",
 active: true,

joseivanlopez / agama-iscsi-apiv2.md

Last active January 27, 2026 15:03

org.opensuse.Agama.Storage1 /org/opensuse/Agama/Storage1 org.opensuse.Agama.Storage1 org.opensuse.Agama.Storage1.Bootloader org.opensuse.Agama.Storage1.ISCSI.Initiator

/org/opensuse/Agama/Storage1/ISCSI

/org/opensuse/Agama/Storage1/iscsi_nodes/1 org.opensuse.Agama.Storage1.ISCSI.Node

joseivanlopez / agama-product-selection.md

Last active November 13, 2025 07:42

Product Selection

What to do when applying a config:

if the product is unknown (invalid, missing):
- add product issue
- keeps the current config and proposal (if any)
- report 400

PUT: the config must indicate a valid product.

joseivanlopez / agama-ui-hooks.md

Last active November 5, 2025 14:56

api.ts
/api/system

queries.ts

hooks/system.ts
hooks/l10n/system.ts
hooks/storage/system.ts

joseivanlopez / agama-organization.md

Last active October 31, 2025 07:34

Current files tree

agama
    CONTRIBUTING.md
    PACKAGING.md
    LICENSE
    PULL_REQUEST_TEMPLATE.md
    README.md
 SECURITY.md

joseivanlopez / agama-new-storage-api.md

Last active October 22, 2025 10:52

New Storage API

Current D-Bus API

org.opensuse.Agama.Storage1                     interface -                     -
.Finish                                         method    -                     -
.GetConfig                                      method    -                     -
.GetConfigModel                                 method    -                     -
.Install method - -

joseivanlopez / agama-state.md

Last active October 6, 2025 12:11

Agama Status

The new API of Agama offers an end-point to retrieve the status of the installation (GET /status).

The status contains the installation state and the progress of each scope in a single JSON file.

Installation State

The installation can be in one of the following states:

joseivanlopez / agama-new-api.md

Last active September 26, 2025 06:27

New HTTP API

The new API is designed around 3 main concepts: system, config and proposal.

system: represents the current status of the running system.
config: represents the configuration for installing the target system.
proposal: represents what is going to be done in the target system.

The config contains elements that can modify the system, the proposal or both. For example, the dasd config changes the system, and the storage config changes the proposal. In other cases like network, the config can affect to both system and proposal.

joseivanlopez / agama-reprobe.md

Last active July 4, 2025 06:54

Agama and Probing

This document analyzes when Agama probes the system and what problems the current approach has, and proposes a possible solution.

When Agama needs to Probe

After selecting a product: a complete probe (software, storage, etc).
After registering a product: a complete probe but keeping some settings (a.k.a., reprobe). For example, storage settings should not be lost.
After editing iSCSI, DASD, zFCP: a storage reprobe.

José Iván López joseivanlopez