> 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/securing/passcode-authentication.md).

# Passcode authentication

Passcode authentication is designed primarily for DeployR servers running on an internal (corporate) network.  Before a task sequence can be executed, the technician needs to specify the passcode that has been configured on the DeployR server.  This means that anyone who knows the passcode value can access any task sequences and content items defined in DeployR.

This is designed primarily to ensure that random users do not accidentally do something (e.g. reimage their computer) that they would later regret.

It is recommended that this passcode be changed periodically.

To configure the passcode, open the "Configure DeployR" shortcut from the Start menu.  Navigate to the "Security Settings" section and type in the desired passcode to use.  Verify the changes, then save them.  Make sure the DeployR service is running.

Note that Entra ID authentication and certificate authentication takes precedence over passcode authentication.  To use passcode authentication, remove the Entra ID auth settings.

{% hint style="info" %}
Note: It is possible to use passcode authentication for task sequences initiated in the full OS, even when Entra ID authentication is enabled.  The passcode value to use can be passed in by setting a variable named "Passcode"; see [Starting a task sequence in an existing OS](/deployr/1.2/starting-a-task-sequence-in-an-existing-os.md)for more information on how to do this.
{% endhint %}

### Verification

To ensure everything is configured and working, boot into Windows PE (using an ISO, PXE, etc.).  You should be challenged to type in the specified passcode:

<figure><img src="/files/5YRhc3lYSQipddGq5SPW" alt=""><figcaption></figcaption></figure>

And the DeployR client will then continue automatically.


---

# 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/securing/passcode-authentication.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.