> For the complete documentation index, see [llms.txt](https://docs.devolutions.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.devolutions.net/server/knowledge-base/knowledge-base-articles/access-uri-format.md).

# Access URI format

During the upgrade process or the installation process of Devolutions Server, an access URI must be provided. This URI is a redirect URL that is used by the open authorization (OAuth) system and redirects the authentication traffic to the access URI.

### Settings

1. In the Devolutions Server Console, go to ***Server – Edit – IIS***.
2. Enter the ***Access URI*** in the text field following the format provided in [Scenarios](https://docs.devolutions.net/server/kb/knowledge-base/access-uri/#scenarios). Click the ellipsis button to add or manage additional access URIs if need be.

{% hint style="success" %}
The access URI is case sensitive and must respect the certificate host name. Ensure that there is no '/' at the end of the URL.
{% endhint %}

![](https://cdnweb.devolutions.net/docs/DVLSCONSOLE2008_2024_2.png)

3. Click ***OK***.
4. If the existing access URI was modified or if a new access URI was created, restart the Devolutions Server instance via the Devolutions Server Console by clicking on ***Stop server***, then ***Start server***.

   ![](https://cdnweb.devolutions.net/docs/DVLSCONSOLE2009_2024_2.png)

### Scenarios

Multiple formats can be set. Select the correct one for the situation.

<table><thead><tr><th width="135">Scenario</th><th width="336">Description</th><th>Format example</th></tr></thead><tbody><tr><td><strong>Internal only</strong></td><td>The Devolutions Server instance is <strong>available internally</strong> only and is <strong>hosted on one server</strong>: The access URI should be set with the FQDN of the machine and end with the Devolutions Server IIS Application if it is not installed on the root of the website.</td><td>https://myservername.mydomain.loc/dvls</td></tr><tr><td><strong>External</strong></td><td>The Devolutions Server instance is <strong>available externally</strong> on the web or behind a load balanced environment: The access URI should be set with the URL you use to reach the instance from the web.</td><td>https://myorganisation.com/dvls</td></tr><tr><td><strong>Root installation</strong></td><td>The Devolutions Server instance is <em><strong>installed at the root</strong></em> of the IIS website: The access URI should only be the FQDN of the machine.</td><td>https://myorganization.com</td></tr><tr><td><strong>Non-standard port</strong></td><td>The Devolutions Server instance is <strong>using a non-standard port</strong> (80 for http, 443 for https): The access URI needs to contain the port number after a colon.</td><td>https://myorganization.com:4443/dvls</td></tr></tbody></table>


---

# 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://docs.devolutions.net/server/knowledge-base/knowledge-base-articles/access-uri-format.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.