Skip to content

Installation profile in the installation medium #160

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
lslezak merged 2 commits into from
Apr 8, 2026
Merged

Installation profile in the installation medium #160

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
7d8cd81
Installation profile in the installation medium
lslezak Apr 8, 2026
838f462
Run prettier
lslezak Apr 8, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 17 additions & 1 deletion docs/overview/unattended.md → docs/overview/unattended.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,8 @@
sidebar_position: 9
---

import { Since } from "@site/src/components/Badge";

# Unattended installation

Agama is able to install a system without user interaction. The user provides a definition of the
Expand Down Expand Up @@ -53,11 +55,25 @@ locations. Agama expects a file named `autoinst.jsonnet`, `autoinst.json` or `au
order) to be located on:

- The root of a file system named `OEMDRV`.
- Or the root (`/`) of the installation environment.
- <Since version="16.1" /> The root of the installation medium, see the instructions below.
- Or the root (`/`) of the installation environment, in the root filesystem image located in the
`/LiveOS/squashfs.img` file in the ISO image.

The first file found is used as the profile, starting the installation right away. If no profile is
found, Agama will fall back to the interactive installation.

### Injecting the installation profile into ISO image

The installaiton profile can be added into the root of the installation medium using this command:

```sh
xorriso -indev agama.iso -outdev agama-auto.iso -boot_image any replay -map profile.json /autoinst.json
```

Where `agama.iso` is the input ISO image, `agama-auto.iso` is the name of the new modified ISO
image, the `profile.json` is the installation profile copied to the `/autoinst.json` location in the
new ISO.

## Fully scripted installation

Specifying [custom scripts](../user/reference/profile/scripts) at the profile and using Jsonnet can
Expand Down
2 changes: 1 addition & 1 deletion docs/overview/webui.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -76,7 +76,7 @@ Agama makes it easy to adjust your network configuration. It allows setting up w
devices, specifying the mode (DHCP/manual), IP addresses, name servers, etc. Advanced connections
types, like bridges or bonds, do not have support in the user interface yet. However, it is a matter
of time that they get added given that Agama supports many of them during an
[unattended installation](./unattended.md) or using the [command-line interface](./cli.md).
[unattended installation](./unattended.mdx) or using the [command-line interface](./cli.md).

:::warning

Expand Down
Loading