Skip to content
English
  • There are no suggestions because the search field is empty.

Modify your localhosts for Offline Mode

  1. 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.io

    Windows

    • 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, not hosts.txt.
    • Open Command Prompt and run ipconfig /flushdns to clear the DNS cache

    2023-09-25 10_35_22-hosts - Notepad

Mac OS

  • Open Terminal
  • Type sudo nano /etc/hosts and 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 mDNSResponder and 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