> 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/getting-started/creating-a-content-item/operating-system.md).

# Operating system

First, create an operating system content item:

<figure><img src="/files/hVBcLgt3t96oJ7PiqWdg" alt=""><figcaption></figcaption></figure>

Next, create a new operating system version, click "+ New version" on the content items details page.

<figure><img src="/files/kVgtRFe2iU6OgY3J9iVB" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/1VkQpDUTNXtP4Z8TPDaX" alt=""><figcaption></figcaption></figure>

You'll then be able to choose your WiM file by clicking "Choose File", browing to your WIM file, and clicking "Open"

<figure><img src="/files/nK3Jq7AUNT16ZceP0eq2" alt=""><figcaption></figcaption></figure>

You then click "Upload All", and watch the super fun status bar while you sip that coffee and check your Discord rooms.<br>

<figure><img src="/files/csSCWdDwtsYBFIEk0I6V" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/NW4xUAZeU0AmgUJ49v2H" alt=""><figcaption></figcaption></figure>

### Troubleshooting during Task Sequence

The most common issues that happen during this step are caused by setting the Content Type to "Folder" instead of Single File.  During the Task Sequence, this will result in the following error:&#x20;

```
Applying image s:\_2P\content\%WIMContentItemGUID%\ index 1 to path S:\
ERROR: Value does not fall within the expected range.
```

On a successful OSD proccess, it would say the file it's applying like so:

```
Applying image s:\_2P\content\%WIMContentItemGUID%\ index 1 to path S:\
```

Other times it's because the index number doesn't exist in the WIM, ex: You're trying to apply Index 5, which is typically PRO, but the WIM you're using only has 1 index because it's been already modified before import.

We have also seen issues due to too low of Memory, this happens most frequently on Virtual Machines with less than 4GB alocated, or when Dynamic Memory is enabled.


---

# 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/getting-started/creating-a-content-item/operating-system.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.
