Modify your localhosts for Offline Mode
-
This article covers adding your Qumulex Gateway to a computer’s hosts file, so that computer can reach the Gateway during an internet outage. It’s needed for each computer (and OS user) that may need offline access. For the full Offline Mode setup, see: https://www.qumulex.com/kb/gateway-offline-access
Before you start, copy or download the DNS List from Settings › Offline Access in QxControl. Each entry is one line: the Gateway’s IP address, a space, and its Hostname.
Ex:
192.168.1.240 qx750010.qumulex.ioWindows
- Press the Windows key and type Notepad
- Right-click Notepad and select Run as administrator
- In Notepad, click File › Open and browse to:
C:\Windows\System32\drivers\etc\ - Change the file type dropdown from Text Documents (*.txt) to All Files, then select hosts and click Open
- Paste the DNS List entries at the bottom of the file (example below)
- Click File › Save. Make sure it saves as
hosts, nothosts.txt. - Open Command Prompt and run
ipconfig /flushdnsto clear the DNS cache

Mac OS
- Open Terminal
- Type
sudo nano /etc/hostsand press Return - Enter your Mac’s admin password
- Use the arrow keys to move the cursor below the existing entries
- Paste the DNS List entries from QxControl
- Press Ctrl + O, then Return to save
- Press Ctrl + X to exit
- Type
sudo killall -HUP mDNSResponderand press Return to clear the DNS cache
Testing
Open a browser and go to the Gateway’s Hostname (ex. https://qx750010.qumulex.io). If the page loads, the hosts file is working. You can do this while the Gateway is still online.
Note: if the Gateway’s IP address changes, these entries must be updated on every computer. That’s why we recommend a DHCP reservation or static IP for the Gateway.
Related articles
- Setting up Offline Mode with Qumulex: https://www.qumulex.com/kb/gateway-offline-access
- Gateway IP Settings: https://www.qumulex.com/kb/qxgateway-static-ip