> For the complete documentation index, see [llms.txt](https://docs.vergeos-demo.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.vergeos-demo.com/knowledge-base/networking/accessing-the-user-interface-from-an-internal-network.md).

# Accessing the User Interface from an Internal Network

## Overview

{% hint style="info" %}
**Key Points**

* Access the vergeOS UI from a VM within your environment
* Create a route rule on the internal network
* Simple process involving dashboard navigation and rule creation
  {% endhint %}

This article guides you through the process of setting up access to the vergeOS User Interface (UI) from a virtual machine (VM) within your vergeOS environment. This is accomplished by creating a specific route rule on the network to which your VM is connected, typically an internal network.

## Prerequisites

* A running vergeOS environment
* A virtual machine (VM) within your vergeOS environment
* Access to the vergeOS dashboard
* Basic understanding of network rules in vergeOS

## Steps

1. Navigate to the Network Dashboard
   * Log into your vergeOS environment
   * Go to the dashboard of the network that your target VM is connected to
2. Create a New Rule

   * Locate the option to create a new rule
   * Use the settings shown in the image below:

   ![ui-access-rule.png](/files/d9z57o76kuSLO0t6FGnK)
3. Submit the Rule
   * After configuring the rule, submit it
   * You will be redirected to the list view of rules on the network
4. Apply the New Rule
   * Click "Apply Rules" to activate the newly created rule
5. Access the UI from the VM
   * Open a web browser within your VM
   * Navigate to the IP address of the Verge UI (e.g., `https://192.168.4.1`)

{% hint style="success" %}
**Pro Tip**

Always ensure that your VM's network settings are correctly configured to use the internal network where you've set up this rule.
{% endhint %}

## Troubleshooting

{% hint style="warning" %}
**Common Issues**

* Problem: Unable to access the UI after creating the rule
  * Solution:
    1. Verify that the rule is applied correctly
    2. Check if the VM's network interface is on the correct network
    3. Ensure no firewall rules are blocking the connection
       {% endhint %}

## Additional Resources

* [Network Overview](/run-the-platform/networking/network-overview.md)
* [Network Rules](/run-the-platform/networking/network-rules.md)
* [Creating an Internal Network](/run-the-platform/networking/internal-networks.md)

## Feedback

{% hint style="info" %}
**Need Help?**

If you encounter any issues while setting up UI access or have questions about this process, please don't hesitate to contact our support team.
{% endhint %}

***

{% hint style="info" %}
**Document Information**

* Last Updated: 2024-08-29
* vergeOS Version: 4.12.6
  {% endhint %}


---

# 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.vergeos-demo.com/knowledge-base/networking/accessing-the-user-interface-from-an-internal-network.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.