Skip to content

Fix TrueNAS "Access from Your IP Is Restricted" (Locked Out)

By Bikram Bhujel
TrueNAS web interface showing Access restricted, Access from your IP is restricted

I locked myself out of my own TrueNAS server with one setting. While tightening security, I added an address to Allowed IP Addresses in the system settings, forgot to include the PC I was working from, and saved. The web interface immediately showed "Access restricted. Access from your IP is restricted" and refused to load.

You do not need to reinstall or reset the configuration. The allowlist can be cleared from the console or over SSH in under a minute. This works on TrueNAS SCALE and on TrueNAS Community Edition 25.04 and newer, which is what SCALE is now called.

Quick answer

Log in to the TrueNAS console or SSH, open the TrueNAS CLI by typing cli, then run system general update ui_allowlist=[] followed by system general ui_restart. Refresh the browser and the login page comes back. Then add your own IP or subnet to the allowlist before restricting it again.

Why TrueNAS shows "Access from your IP is restricted"

TrueNAS can limit which IP addresses or networks may open the web interface, under System > General Settings > GUI > Allowed IP Addresses. When the list is not empty, every address that is not on it gets the restricted page. You will hit this if:

  • you added a single IP and forgot the PC you were using,
  • your PC got a new address from DHCP after a reboot,
  • you connect over a VPN or from another VLAN that uses a different subnet, or
  • you typed the network in the wrong format, for example 192.168.1.0 instead of 192.168.1.0/24.
TrueNAS GUI settings with the Allowed IP Addresses field

Fix 1: Clear the allowlist with the TrueNAS CLI

  1. Get a shell on the server. Either connect a monitor and keyboard and pick the shell option from the console menu, or SSH in from a machine that still has access: ssh admin@TRUENAS-IP.
  2. Start the TrueNAS CLI by typing cli and pressing Enter.
  3. Clear the list and restart the web service:
system general update ui_allowlist=[]
system general ui_restart
  1. Wait about 20 seconds, then refresh the page in your browser.

Fix 2: Use midclt from a normal shell

If you are already in the Linux shell and do not want to open the CLI, the same change works through the middleware client. Run it as root or with sudo:

sudo midclt call system.general.update '{"ui_allowlist": []}'
sudo midclt call system.general.ui_restart

No SSH and no console access?

If SSH is off and the server has no monitor, the only way in is physical: connect a screen and keyboard, or use the server's IPMI or iKVM if it has one. Worst case, you can boot a fresh TrueNAS install and upload a saved configuration file, which is why I keep a config backup after every big change (System > General Settings > Manage Configuration > Download File).

How to use the allowlist without locking yourself out

  • Add networks, not single IPs. 192.168.1.0/24 covers your whole home LAN, so a new DHCP lease will not lock you out.
  • Add your VPN subnet too if you manage TrueNAS over WireGuard or Tailscale.
  • Keep SSH enabled with key login as your back door, or at least know where the console is.
  • Test from a second device before closing your current session.
  • For access from outside your home, a VPN or a Cloudflare Tunnel in front of TrueNAS is safer than opening ports.

If you are still setting up the server, my TrueNAS home server build covers the rest of the configuration.

Frequently asked questions

How do I fix "Access from your IP is restricted" in TrueNAS?

Open a shell on the server, type cli, then run system general update ui_allowlist=[] and system general ui_restart. This empties the Allowed IP Addresses list so every address can reach the web interface again.

Where is the Allowed IP Addresses setting in TrueNAS?

In System, General Settings, under the GUI section. Leaving the list empty allows every address; anything you add becomes the only addresses that can open the web interface.

Will clearing the allowlist delete my pools or shares?

No. It only changes which addresses may open the web interface. Pools, datasets, shares and apps are not touched.

Does this work on TrueNAS Community Edition?

Yes. TrueNAS SCALE was renamed TrueNAS Community Edition from version 25.04, and the same CLI and midclt commands work there.

Can I allow a whole subnet instead of one IP?

Yes. Enter the network in CIDR format, such as 192.168.1.0/24, to allow every device on that network.

Comments

Questions and corrections are welcome. I read every comment before it appears, and remove spam and promotional links.