Skip to content

Commit 06e0b7d

Browse files
committed
chore(merge): reconcile main into l10n_main
- merge origin/main into l10n_main after the docs update-page reorganization - preserve the Docusaurus 3.10 upgrade and MDX heading anchor fixes from this branch - keep main's newer updating-unraid structure while resolving path and content conflicts - leave local-only .codex/ and internal/ files untracked and out of the branch
2 parents 0d9b41d + 306add7 commit 06e0b7d

35 files changed

Lines changed: 438 additions & 320 deletions

.github/workflows/fork-preview-deploy.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -64,7 +64,7 @@ jobs:
6464
- name: Setup Node.js
6565
uses: actions/setup-node@v6
6666
with:
67-
node-version: 24.14.1
67+
node-version: 24.15.0
6868

6969
- name: Deploy preview to Cloudflare Pages
7070
id: deploy

.nvmrc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
24.14.1
1+
24.15.0

docs/unraid-connect/overview-and-setup.mdx

Lines changed: 10 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -17,11 +17,12 @@ Unraid Connect works seamlessly with Unraid OS, boosting your server experience
1717

1818
With Unraid Connect, you can:
1919

20-
- Remotely access and manage your Unraid server from any device, anywhere in the world.
20+
- Monitor your server and manage supported Connect features from any device, anywhere in the world.
2121
- Monitor real-time server health and resource usage, including storage, network, and Docker container status.
2222
- Perform and schedule secure online flash backups to protect your configuration and licensing information.
2323
- Receive notifications about server health, storage status, and critical events.
24-
- Use dynamic remote access and server deep linking to navigate to specific management pages or troubleshoot issues quickly.
24+
- Manage supported server actions through the Connect dashboard without exposing the full %%WebGUI|web-gui%% to the internet.
25+
- Use remote access links and server deep linking to navigate to specific management pages or troubleshoot issues quickly.
2526
- Manage multiple servers from a single dashboard, making it perfect for users with more than one Unraid system.
2627

2728
Unraid Connect is more than just an add-on; it's an essential extension of the Unraid platform, designed to maximize the value, security, and convenience of your Unraid OS investment.
@@ -114,16 +115,19 @@ When you click **Details** on a server, you will see:
114115

115116
:::tip
116117

117-
To use all management features, provision a myunraid.net certificate under ***Settings → Management Access*** on your server.
118+
For full remote administration, prefer the official [%%Tailscale|tailscale%% integration](../unraid-os/system-administration/secure-your-server/tailscale.mdx). It gives you private remote access to the %%WebGUI|web-gui%% and services without exposing them to the public internet.
118119

119120
:::
120121

121-
With a valid **myunraid.net** certificate, Unraid Connect enables secure, remote server management directly from the Connect web interface.
122+
Signing in to Unraid Connect gives you secure dashboard access without exposing the %%WebGUI|web-gui%% directly to the internet. The server maintains a secure outbound connection that enables supported Connect features with restricted API access.
123+
124+
If you also enable **Unraid Connect Remote Access**, that separate feature exposes the full %%WebGUI|web-gui%% through WAN port forwarding or %%UPnP|upnp%%. Use it only when you specifically need public browser access to the %%WebGUI|web-gui%%.
122125

123126
Remote management features include:
124127

125-
- **Remote WebGUI access:** Access the %%WebGUI|web-gui%% from anywhere.
126-
- **Array controls:** Start or stop %%array|array%%s and manage storage pools.
128+
- **Dashboard-based management:** Use supported Connect controls without opening the full %%WebGUI|web-gui%% to the internet.
129+
- **Optional Remote WebGUI access:** Access the full %%WebGUI|web-gui%% from anywhere if you separately enable Unraid Connect Remote Access.
130+
- **Array controls:** Start or stop %%array|array%%s and manage storage pools through supported Connect actions.
127131
- **Docker and VM management:** View, start, stop, and monitor containers and %%VM|vm%%s.
128132
- **Parity & Scrub:** Launch %%parity check|parity-check%% or %%ZFS|zfs%%/%%BTRFS|btrfs%% scrub jobs
129133
- **Flash backup:** Trigger and monitor flash device backups to the cloud.

docs/unraid-connect/remote-access.mdx

Lines changed: 33 additions & 49 deletions
Original file line numberDiff line numberDiff line change
@@ -3,30 +3,31 @@ sidebar_position: 3
33
sidebar_label: Remote access
44
---
55

6-
import Tabs from '@theme/Tabs';
7-
import TabItem from '@theme/TabItem';
8-
import RemoteAccessDynamic from './partials/remote-access/dynamic.mdx';
9-
import RemoteAccessStatic from './partials/remote-access/static.mdx';
10-
116
# Remote access
127

13-
Unlock secure, browser-based access to your Unraid %%WebGUI|web-gui%% from anywhere with remote access. This feature is ideal for managing your server when you're away from home - no complicated networking or %%VPN Tunnel|vpn-tunnel%% setup is required. For more advanced needs, such as connecting to Docker containers or accessing network drives, a %%VPN Tunnel|vpn-tunnel%% remains the recommended solution.
8+
This page covers **Unraid Connect Remote Access**, which publishes your %%WebGUI|web-gui%% to the internet by using either %%UPnP|upnp%% or a manual port forwarding rule on your router. If you want full remote management without exposing the %%WebGUI|web-gui%% to WAN traffic, prefer the official [%%Tailscale|tailscale%% integration](../unraid-os/system-administration/secure-your-server/tailscale.mdx). For more advanced needs, such as connecting to Docker containers or accessing network drives, a %%VPN Tunnel|vpn-tunnel%% remains the recommended solution.
149

1510
:::important[Security reminder]
1611

1712
Before enabling remote access, ensure your root password is strong and unique. Update it on the **Users** page if required. Additionally, keep your Unraid OS updated to the latest version to protect against security vulnerabilities. [Learn more about updating Unraid here](../unraid-os/system-administration/maintain-and-update/upgrading-unraid.mdx).
1813

1914
:::
2015

16+
:::note[Connect dashboard access is different]
17+
18+
Signing in to the [Unraid Connect dashboard](https://connect.myunraid.net/) does **not** by itself expose your %%WebGUI|web-gui%% to the internet. Dashboard access uses a server-initiated connection with restricted API access for supported Connect features. **Unraid Connect Remote Access** is a separate feature that exposes the full %%WebGUI|web-gui%% through WAN port forwarding or %%UPnP|upnp%%.
19+
20+
:::
21+
2122
Remote access through Unraid Connect provides:
2223

23-
- **Convenience** - Quickly access your server’s management interface from anywhere, using a secure, cloud-managed connection.
24-
- **Security** - Dynamic access modes limit exposure by only allowing access to the internet when necessary, which helps reduce risks from automated attacks.
25-
- **Simplicity** - No need for manual port forwarding or VPN client setup for basic management tasks.
24+
- **Convenience** - Quickly access your server’s management interface from anywhere, using a trusted Unraid Connect URL.
25+
- **Security** - Your %%WebGUI|web-gui%% traffic is encrypted when SSL/TLS is configured correctly.
26+
- **Simplicity** - %%UPnP|upnp%% can create the required port mapping automatically when your router supports it.
2627

27-
:::tip
28+
:::tip[Preferred approach]
2829

29-
For full network access or advanced use cases, consider setting up [Tailscale](../unraid-os/system-administration/secure-your-server/tailscale.mdx) or a VPN solution.
30+
For most users, the official [%%Tailscale|tailscale%% integration](../unraid-os/system-administration/secure-your-server/tailscale.mdx) is the better choice for remote administration because it avoids exposing the %%WebGUI|web-gui%% to the public internet. Use Unraid Connect Remote Access only when you specifically need browser access to the public-facing %%WebGUI|web-gui%% URL.
3031

3132
:::
3233

@@ -45,45 +46,32 @@ Your Unraid server will be ready to accept secure remote connections via the %%W
4546

4647
---
4748

48-
## Choosing a remote access type
49-
50-
Unraid Connect offers two modes:
49+
## Choosing a remote access configuration
5150

52-
<Tabs>
53-
<TabItem value="dynamic" label="Dynamic remote access" default>
54-
<RemoteAccessDynamic />
55-
</TabItem>
51+
In current Unraid 7.2.x releases, the Unraid API settings page exposes these remote access controls:
5652

57-
<TabItem value="static" label="Static remote access">
58-
<RemoteAccessStatic />
59-
</TabItem>
60-
</Tabs>
53+
- **Allow Remote Access** - Choose whether remote access is **Disabled** or **Always** available.
54+
- **Remote Access Forward Type** - Choose **Static** for manual port forwarding, or **UPnP** to let your router create the port mapping automatically.
55+
- **Remote Access WAN Port** - Choose the WAN port to forward when using **Static** forwarding.
6156

62-
| Feature | Dynamic remote access | Static remote access |
63-
| ------------------------------------ | --------------------------- | ------------------------- |
64-
| %%WebGUI\|web-gui%% open to internet | Only when enabled | Always |
65-
| Attack surface | Minimized | Maximized |
66-
| Automation | Auto open/close via Connect | Manual setup, always open |
67-
| %%UPnP\|upnp%% support | Yes | Yes |
68-
| | **Recommended for most** | |
57+
When remote access is set to **Always**, your %%WebGUI|web-gui%% is continuously reachable from the internet on the configured WAN port. Both **Static** and **UPnP** remote access publish the %%WebGUI|web-gui%% to WAN traffic. Use a strong root password, keep Unraid OS updated, and disable remote access when you do not need it.
6958

70-
## Dynamic remote access setup
59+
Dynamic, on-demand remote access is not currently exposed in the Unraid API settings page. If you need remote management without keeping the %%WebGUI|web-gui%% exposed through port forwarding, prefer [%%Tailscale|tailscale%%](../unraid-os/system-administration/secure-your-server/tailscale.mdx) or another %%VPN Tunnel|vpn-tunnel%%.
7160

72-
To set up dynamic remote access:
61+
## Enable remote access
7362

74-
1. In ***Settings → Management Access → Unraid API***, select a dynamic option from the Remote Access dropdown:
75-
- **Dynamic - UPnP:** Uses %%UPnP|upnp%% to open and close a random port automatically (requires %%UPnP|upnp%% enabled on your router).
76-
- **Dynamic - Manual port forward:** Requires you to forward the selected port on your router manually.
77-
78-
2. Navigate to [Unraid Connect](https://connect.myunraid.net/), and go to the management or server details page.
79-
80-
3. The **Dynamic remote access** card will show a button if your server isn’t currently accessible from your location.
81-
82-
4. Click the button to enable WAN access. If using %%UPnP|upnp%%, a new port forward lease is created (typically for 30 minutes) and auto-renewed while active.
63+
To enable remote access:
8364

84-
5. The card will display the current status and %%UPnP|upnp%% state.
65+
1. In the Unraid %%WebGUI|web-gui%%, navigate to ***Settings → Management Access*** and open the **Unraid API Settings** tab.
66+
2. Set **Allow Remote Access** to **Always**.
67+
3. Choose a **Remote Access Forward Type**:
68+
- **UPnP:** Lets Unraid ask your router to create the WAN port mapping automatically. This requires %%UPnP|upnp%% support and %%UPnP|upnp%% enabled on your router.
69+
- **Static:** Requires you to create the port forwarding rule manually on your router.
70+
4. If you choose **Static**, enter the **Remote Access WAN Port** you want to use.
71+
5. Click **Apply**.
72+
6. Log in to [Unraid Connect](https://connect.myunraid.net/) and click the **Manage** link to connect to your server remotely.
8573

86-
6. After 10 minutes of inactivity - or if you click **Disable remote access** - internet access is automatically revoked. %%UPnP|upnp%% leases are removed as well.
74+
If the **Manage** link does not work, use the relevant forwarding section below to verify that the WAN port reaches your server's HTTPS port.
8775

8876
---
8977

@@ -100,13 +88,11 @@ To configure %%UPnP|upnp%%:
10088
Navigate to ***Settings → Management Access*** and change **Use %%UPnP|upnp%%** to **Yes**.
10189

10290
3. **Select %%UPnP|upnp%% in Unraid Connect.**
103-
On the Unraid Connect settings page, choose the remote access option as %%UPnP|upnp%% (select either Dynamic or Always On) and then click **Apply**.
91+
On the Unraid API settings page, set **Allow Remote Access** to **Always**, set **Remote Access Forward Type** to **UPnP**, and then click **Apply**.
10492

105-
4. **Verify port forwarding (Always On only).**
93+
4. **Verify port forwarding.**
10694
Click the **Check** button. If successful, you'll see the message, "Your Unraid Server is reachable from the Internet."
10795

108-
For Dynamic forwarding, you need to click **Enable Dynamic Remote Access** in [Unraid Connect](https://connect.myunraid.net/) to allow access.
109-
11096
:::caution[Troubleshooting]
11197

11298
If the setting changes from %%UPnP|upnp%% to Manual Port Forward upon reloading, Unraid might not be able to communicate with your router. Double-check that %%UPnP|upnp%% is enabled and consider updating your router's firmware.
@@ -129,9 +115,7 @@ To configure manual port forwarding:
129115

130116
Some routers may require the WAN port and HTTPS port to match. If so, use the same high random number for both.
131117

132-
4. **Verify port forwarding (Always On only):** Press the **Check** button. If everything is correct, you’ll see “Your Unraid Server is reachable from the Internet.”
133-
134-
For dynamic forwarding, ensure to click **Enable Dynamic Remote Access** in [Unraid Connect](https://connect.myunraid.net/) to enable access.
118+
4. **Verify port forwarding:** Press the **Check** button. If everything is correct, you’ll see “Your Unraid Server is reachable from the Internet.”
135119

136120
5. **Access your server:** Log in to [Unraid Connect](https://connect.myunraid.net/) and click the **Manage** link to connect to your server remotely.
137121

docs/unraid-os/advanced-configurations/_category_.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,4 +4,4 @@
44
"link": {
55
"type": "generated-index"
66
}
7-
}
7+
}

docs/unraid-os/download_list.mdx

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,14 @@
11
---
2-
sidebar_position: 7
3-
title: Version history
2+
sidebar_position: 9
3+
title: Version Archive
44
---
55

66
import {VersionsTable} from '@site/src/components/VersionsTable';
77

8-
# Version history
8+
# Version Archive
99

10-
Need the USB Creator? [Getting Started With Unraid](https://unraid.net/getting-started)
10+
Use this archive to find release notes and download links for Unraid OS versions. To update an existing server, use the built-in updater; see the [standard update process](./updating-unraid/index.mdx#standard-update-process) for steps. To create a new boot device, use the [Unraid USB Creator](https://unraid.net/download).
11+
12+
If you are deciding which release to install, start with [Unraid OS release types](./updating-unraid/release-types.mdx).
1113

1214
<VersionsTable />

docs/unraid-os/getting-started/set-up-unraid/internal-boot-faq.mdx

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -35,6 +35,20 @@ This page contains frequently asked questions about internal boot in Unraid OS.
3535
</div>
3636
</details>
3737

38+
### I switched from flash boot to internal boot, but the system still boots from flash. What should I do? {/* #internal-boot-bios-order */}
39+
### Why would I use internal boot instead of a USB flash drive? {/* #internal-boot-benefits */}
40+
41+
Internal boot is optional. If your USB flash boot setup is reliable and fits your server, you do not need to switch just because internal boot exists.
42+
43+
Internal boot solves a few practical problems:
44+
45+
- It reduces reliance on USB flash media. Internal SSD, NVMe, or eMMC devices are generally more durable than inexpensive USB flash drives and are less likely to be bumped, removed, or damaged.
46+
- It supports mirrored boot devices. With two internal boot devices, Unraid can continue booting if one device fails.
47+
- It works better for systems where USB boot is awkward, exposed, unreliable, or not preferred by the hardware design.
48+
- It lets you choose a dedicated boot pool for boot-only devices, or a boot + data pool when you want to reserve part of a larger device for boot and use the remaining capacity as a normal pool.
49+
50+
Internal boot does not make the array faster during normal operation, and it is not required for servers that are already booting reliably from USB.
51+
3852
### I switched from flash boot to internal boot, but the system still boots from flash. What should I do? {/* #internal-boot-bios-order */}
3953

4054
Unraid attempts to update the UEFI boot order automatically. If that does not take effect, manually move your internal boot device(s) to the top of your BIOS/UEFI boot order, save changes, and reboot.

docs/unraid-os/release-notes/7.2.0.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ Note that some plugins may have visual issues in this release; please give plugi
66

77
## Upgrading
88

9-
For step-by-step instructions, see [Upgrading Unraid](../../unraid-os/system-administration/maintain-and-update/upgrading-unraid.mdx). Questions about your [license](../../unraid-os/troubleshooting/licensing-faq.mdx#license-types--features)?
9+
For step-by-step instructions, see [Updating Unraid](/unraid-os/updating-unraid/). Questions about your [license](../../unraid-os/troubleshooting/licensing-faq.mdx#license-types--features)?
1010

1111
### Known issues
1212

docs/unraid-os/release-notes/7.2.1.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ This is a small update with some great fixes and improvements.
44

55
## Upgrading
66

7-
For step-by-step instructions, see [Upgrading Unraid](../../unraid-os/system-administration/maintain-and-update/upgrading-unraid.mdx). Questions about your [license](../../unraid-os/troubleshooting/licensing-faq.mdx#license-types--features)?
7+
For step-by-step instructions, see [Updating Unraid](/unraid-os/updating-unraid/). Questions about your [license](../../unraid-os/troubleshooting/licensing-faq.mdx#license-types--features)?
88

99
### Known issues
1010

docs/unraid-os/release-notes/7.2.2.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ If you are on 7.2.0 or earlier you can skip straight to 7.2.2.
88

99
## Upgrading
1010

11-
For step-by-step instructions, see [Upgrading Unraid](../../unraid-os/system-administration/maintain-and-update/upgrading-unraid.mdx). Questions about your [license](../../unraid-os/troubleshooting/licensing-faq.mdx#license-types--features)?
11+
For step-by-step instructions, see [Updating Unraid](/unraid-os/updating-unraid/). Questions about your [license](../../unraid-os/troubleshooting/licensing-faq.mdx#license-types--features)?
1212

1313
### Known issues
1414

0 commit comments

Comments
 (0)