> For the complete documentation index, see [llms.txt](https://documentation.2pintsoftware.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.2pintsoftware.com/deployr/1.2/reference/step-definitions/install-ubuntu-desktop-from-iso.md).

# Install Ubuntu Desktop from ISO

{% hint style="info" %}
This is only supported in DeployR Enterprise.  Applies to: DeployR 1.1 and later.
{% endhint %}

The **Install Ubuntu Desktop from ISO** step is used to perform an unattended installation of Ubuntu Desktop using an ISO file that has been added to DeployR as a content item.  The flags on this content item must be marked to "Allow Anonymous Read" since this file is downloaded by the Linux kernel without authentication.  Note that the entire ISO will be downloaded into a RAMdisk, so the memory available on the machine must be large enough; 12-16GB is recommended.

In addition to the ISO, a second content item containing the initrd and vmlinuz files extracted by the ISO.  These can be found in the "casper" subdirectory in the ISO.

This is supported for Ubuntu Desktop 23.04 and later releases.

<figure><img src="/files/0UB9lCizxtkMC4IyjGpH" alt=""><figcaption></figcaption></figure>

Specify the storage layout to use and the user account name that should be created.  The password for that account can be stored as a secret named "AdminPassword".  If the secret is not configured, the AdminPassword task sequence variable value will be used.  If that value is blank, a random 32-character password will be generated.

Choose a storage layout as well.  If selecting lvm, LUKS encryption can also be enabled by specifying the LUKS passphrase that should be used to unlock the device; Linux will automatically prompt for this value during the boot process.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://documentation.2pintsoftware.com/deployr/1.2/reference/step-definitions/install-ubuntu-desktop-from-iso.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.