> For the complete documentation index, see [llms.txt](https://www.opal-rt.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.opal-rt.com/docs/hypersim/overview/workstation-requirements/installation-and-permissions.md).

# Installation & Permissions

## Installation requirements

**Administrator privileges are needed for installation**, but not for running HYPERSIM.

The default installation path is `C:\OPAL-RT\HYPERSIM`.

## Workspace folder <a href="#workspace-folder" id="workspace-folder"></a>

The workspace must be a **local folder** with full **read, write, and execute** permissions. By default, it is located in the user’s directory (e.g., `C:\Users\`*`userName`*`\HYPERSIM`).

* **Important:** HYPERSIM does not support spaces in the path.
* In rare cases, usernames containing capital letters may cause errors when writing to the target code directory. If this occurs, run the **Target Manager Diagnostic** tool for more information.
* Online folders (SharePoint, OneDrive) are **not supported**.
* Logs and user preferences are also stored in `C:\Users\`*`userName`*`\HYPERSIM`
* Models can be saved in any location, but ensure the path is not excessively long, as generated files may exceed the Windows maximum path length.

## Required accessible ports

Firewall settings must allow the processes in the table below to access the ports they require.

<table><thead><tr><th width="199.90911865234375">Process Name</th><th width="244.9090576171875">Usage</th><th>Ports</th></tr></thead><tbody><tr><td><strong>Hyperworks</strong></td><td>Design interface</td><td>13510, 32768-65535</td></tr><tr><td><strong>HyWorks</strong></td><td>Main HYPERSIM application</td><td>111, 600-1023, 4569, 13510</td></tr><tr><td><strong>HyCore</strong></td><td>Simulator interaction application</td><td>111, 600-1023, 13500, 32768-65535</td></tr><tr><td><strong>ActivationTool</strong></td><td>Workstation license installation</td><td>111, 600-1023</td></tr><tr><td><strong>IOGuiFX</strong></td><td>I/O Interface and DataLogger configuration application</td><td>111, 600-1023, 17510</td></tr><tr><td><strong>Scopeview</strong></td><td>ScopeView software</td><td>111, 600-1023, 13501</td></tr><tr><td><strong>TestView</strong></td><td>TestView software</td><td>111, 600-1023</td></tr><tr><td><strong>UcmBuilder</strong></td><td>UCM editor tool</td><td>111, 600-1023</td></tr><tr><td><strong>Diagnostic_Tool</strong></td><td>Setup analyzing tool</td><td>N/A</td></tr><tr><td><strong>hyServMain</strong></td><td>Simulation setup and interface</td><td>17510, 49152-65535</td></tr><tr><td><strong>hypersim</strong></td><td>Circuit engine application</td><td>600-1023, 32768-49151</td></tr><tr><td><strong>psql</strong></td><td>Tool to enable queries on the database server</td><td>N/A</td></tr><tr><td><strong>Opal One Database</strong></td><td>PostgreSQL database service</td><td>60770</td></tr><tr><td><strong>Opal One App Server</strong></td><td>Unicon processes manager</td><td>60780</td></tr><tr><td><strong>Unicon</strong></td><td>Resource manager for OPAL-RT applications</td><td>49152–65535*</td></tr><tr><td><strong>Maestro (TCP/IP)</strong></td><td>Resource management server (shared socket)</td><td>60781</td></tr><tr><td><strong>Maestro (gRPC)</strong></td><td>Resource management server (gRPC)</td><td>60782</td></tr><tr><td><strong>Maestro (gRPC proxy)</strong></td><td>Resource management server (gRPC proxy)</td><td>60783</td></tr><tr><td><strong>Opal-services-handler</strong></td><td>Launches Opal One Database, Maestro, and App Server</td><td>None</td></tr><tr><td><strong>Unified Database</strong></td><td>Schematic Editor database</td><td>60777</td></tr><tr><td><strong>Unified Database HTTP server</strong></td><td>Schematic Editor back-End</td><td>60778</td></tr><tr><td><strong>Schematic Editor</strong></td><td>Electron App</td><td>61823</td></tr><tr><td><strong>Schematic Editor</strong></td><td>.NET Servers</td><td>61822, 65011</td></tr><tr><td><strong>Schematic Editor</strong></td><td>Node Server</td><td>65012</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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://www.opal-rt.com/docs/hypersim/overview/workstation-requirements/installation-and-permissions.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
