Installing SUSE Linux Enterprise Server Manually Using Agama
- WHAT?
This article describes how to install SUSE Linux Enterprise Server using Agama. The information presented here applies to installation of the products on both bare metal and virtual machines.
- WHY?
Read this article to understand the process of installing SUSE Linux Enterprise Server using Agama.
- EFFORT
You may need 15 minutes to read this article.
- GOAL
Learn how to manually install SUSE Linux Enterprise Server using Agama.
- REQUIREMENTS
A bare metal server or a virtual machine. For server installations without any desktop environment, SUSE recommends a minimum of 1 CPU, 2 GB memory and 32 GB storage (which includes storage for Btrfs snapshots in the root partition, swap space, and storage for software packages).
An active registration code for the product you want to install. You can generate a registration code for the product and activate its subscription for your organization at the SUSE Customer Center.
Note: Optional registrationCertain images that are signed with the developer's key may allow you to skip registration before or while installation. Besides, certain images may contain all installable packages for your operating system that you can use as an offline package repository. In such cases, you may not need an active registration code before installation. However, if you use software packages from the official online repositories, SUSE recommends registering your product with the SUSE Customer Center.
1 Introduction to Agama #
This section provides a short overview of Agama, which is the default installer for SUSE Linux Enterprise Server 16.0 and later versions.
1.1 What is Agama? #
Agama is a flexible and powerful open source installer developed by SUSE. You can use it to perform manual or automated installation of supported SUSE Linux Enterprise Server versions on a variety of machine architectures. The Agama‐based installation method provides an intuitive interface for ready‐to‐use images for different use cases and workloads. In combination with Cockpit and Ansible, it substitutes YaST in SUSE Linux Enterprise Server.
2 Installing SUSE Linux Enterprise Server using Agama #
This section describes how to install SUSE Linux Enterprise Server using the Agama‐based ISO image file.
2.1 Introduction #
The following sections describe the Agama‐based manual installation procedure for SUSE Linux Enterprise Server. The information applies to installation on both bare metal and virtual machines.
2.2 Requirements #
An Agama‐based ISO image file for supported versions of SUSE Linux Enterprise Server. You can download it from the SUSE Customer Center and verify its checksum to ensure its integrity.
Note: Available images for productsThe Agama‐based installation image is available for SUSE Linux Enterprise Server 16.0 and later versions.
2.3 Manually installing SUSE Linux Enterprise Server for x86_64 using Agama #
To manually install SUSE Linux Enterprise Server using Agama, perform the following steps:
Select a bootable media and start the installation process.
For a bare metal server, select the device or storage volume from which to boot.
For a virtual machine guest, select the path to the image file and create a virtual machine with a configuration that is appropriate for the anticipated workload.
In the GRUB 2 boot menu, select .
Select SUSE Linux Enterprise Server 16.0 for installation and accept the license to continue.
The overview with the most relevant installation settings is shown. Adjust the settings by selecting the category from the menu on the left or directly proceed with the installation.
Tip: Installer language and keyboardClick the arrow menu in the top right corner and select to change the language and keyboard layout used by the installer. The language can only be changed on local installations. If you are using a web browser for a remote installation, configure the preferred content language in the browser settings and reload the installer.
Register your product. Enter a registration code and optionally a valid email address.
Note: Optional registration for images signed with the developer's keyImages signed with the developer's key may allow you to skip registration before installation. If your product's image supports installation without registration, you may see a pop-up similar to the following:
To install without registration, select on the pop-up.
(Optional) Adjust your localization settings such as language, keyboard layout and time zone.
(Optional) Configure your network settings. To edit an existing network connection, click the three dots.
Select a storage device for installation.
Currently installations on single discs or LVM are supported. To change the disk or use LVM, click the device name button in the section.
To detect an iSCSI disk, select the iSCSI initiator and click .
By default, the file systems will be allocated as new partitions on the selected device. You can change this behavior in the drop-down list labeled drop-down list in the section. The following space policies are available:
Space policies #- Delete current content
All partitions will be removed and any data on the disks will be lost.
- Shrink existing partitions
The data is kept, but current partitions will be shrinked as needed.
- Use available space
The data is kept. Only the space not assigned to any partition will be used.
- Custom
Select what to do with each partition.
To edit individual partitions, expand the section by clicking on the Optionally, you can configure Btrfs snapshots, boot options and enable full disk encryption (FDE).
(Optional) Add additional software to install such as the KVM hypervisor or Cockpit system management service.
Note: Trust the GPG key for the Package Hub repositoryIf you select the Package Hub add-on and see a popup, trust the GPG key for that repository.
Configure the authentication settings.
Important: No SSHrootaccessSSH access for
rootis disabled by default. Therefor it is strongly recommended to create a system user. The first system user is grantedsudoprivileges automatically and can also be used for accessing Cockpit.Create a non-root user. Click and enter details such as user name and password.
Configure the authentication methods for the
root. You can use a secure password, a SSH public key, or both.
Click and confirm to start the installation.
Wait for the system installation to complete. It takes around 30 minutes to complete the installation.
Tip: Installation logsYou can use the arrow menu in the top right corner of the window to view the logs and system messages.
Once the installation is complete, select .
Using the GRUB 2 boot menu, boot into the newly installed system.
2.4 Summary #
After successful configuration checks, product registration, installation and reboot, verify that you can log in and use your system.
3 For more information #
For information on related topics, refer to the following resources:
Documentation of the Agama open-source project: https://agama-project.github.io/docs
4 Legal Notice #
Copyright© 2006–2025 SUSE LLC and contributors. All rights reserved.
Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.2 or (at your option) version 1.3; with the Invariant Section being this copyright notice and license. A copy of the license version 1.2 is included in the section entitled “GNU Free Documentation License”.
For SUSE trademarks, see https://www.suse.com/company/legal/. All other third-party trademarks are the property of their respective owners. Trademark symbols (®, ™ etc.) denote trademarks of SUSE and its affiliates. Asterisks (*) denote third-party trademarks.
All information found in this book has been compiled with utmost attention to detail. However, this does not guarantee complete accuracy. Neither SUSE LLC, its affiliates, the authors, nor the translators shall be held liable for possible errors or the consequences thereof.
















