JavaScript must be enabled in your browser for CasaOS to work properly

CasaOS is a home server operating system that runs in your web browser. If JavaScript is turned off, the interface will not load correctly — you will see a blank page or error messages instead of the dashboard where you manage your apps and settings. Enabling JavaScript takes less than a minute and involves changing one setting in your browser.

The steps differ slightly depending on which browser you use. This guide covers Chrome, Firefox, Safari, and Edge, which are the most common browsers for accessing CasaOS on home networks.

Key Takeaways

  • JavaScript is a programming language that makes web pages interactive, and CasaOS requires it to display your dashboard and control your apps.
  • Most browsers have JavaScript enabled by default, so you only need to change this setting if you deliberately turned it off or use a privacy-focused browser.
  • Enabling JavaScript in Chrome, Firefox, Safari, and Edge each takes a different path through the browser settings, but the end result is the same.
  • After you enable JavaScript, refresh the CasaOS page in your browser — use Ctrl+R on Windows or Cmd+R on Mac.

Enable JavaScript in Google Chrome

Open Chrome and click the three vertical dots in the top right corner. Select Settings from the menu that appears. On the left side, click Privacy and security, then click Site settings.

Scroll down and look for JavaScript. Click it. You will see two options: Allowed and Blocked. Make sure Allowed is selected. If you see CasaOS listed under "Blocked sites", click the X next to it to remove the block.

Close the settings tab and go back to your CasaOS page. Press Ctrl+R (Windows) or Cmd+R (Mac) to refresh. The dashboard should now load.

Enable JavaScript in Mozilla Firefox

Open Firefox and type about:config in the address bar, then press Enter. You will see a warning page — click Accept the Risk and Continue.

In the search box at the top, type javascript.enabled. You will see one result. If the value shows false, click the toggle button on the right to change it to true. If it already shows true, JavaScript is already enabled.

Close the tab and return to CasaOS. Press Ctrl+R (Windows) or Cmd+R (Mac) to refresh the page.

Enable JavaScript in Safari

Open Safari and click Safari in the top menu bar. Select Settings (or Preferences on older versions). Click the Security tab.

Look for the checkbox that says Enable JavaScript. Make sure it is checked. If it is unchecked, click it to turn JavaScript on.

Close the settings window and return to CasaOS. Press Cmd+R to refresh the page.

Enable JavaScript in Microsoft Edge

Open Edge and click the three horizontal dots in the top right corner. Select Settings. On the left side, click Privacy, search, and services. Scroll down to the Security section.

Click Site permissions, then click JavaScript. Make sure the toggle for Allowed is turned on (it should be blue). If CasaOS appears under "Block", click the X next to it to remove the block.

Close settings and go back to CasaOS. Press Ctrl+R to refresh the page.

What to do if CasaOS still does not load

After enabling JavaScript and refreshing, the CasaOS dashboard should appear. If it does not, clear your browser cache — this removes stored data that might be outdated. In Chrome, Firefox, and Edge, press Ctrl+Shift+Delete (Windows) or Cmd+Shift+Delete (Mac). Select All time and check Cookies and other site data and Cached images and files, then click Clear data.

In Safari, click Safari in the menu bar, then Settings, then the Privacy tab. Click Manage Website Data, find CasaOS in the list, and click Remove. Close settings and refresh the page.

If the page still does not load, check that you are using the correct address for your CasaOS instance. This is usually something like http://192.168.1.100:80 or http://casaos.local, depending on your network setup. Verify the address with whoever set up your CasaOS server.

Frequently Asked Questions

Why would JavaScript be turned off?

Most people never turn it off — it comes enabled by default in all major browsers. You might have disabled it manually for privacy reasons, or you might be using a privacy-focused browser like Tor Browser that blocks JavaScript by default. If you do not remember turning it off, it is probably still on.

Is it safe to enable JavaScript?

JavaScript is safe when you are accessing trusted websites on your own network, like CasaOS. It becomes a security concern only if you enable it on untrusted public websites. Since CasaOS runs on your home network, enabling JavaScript for it poses no practical risk.

Do I need to enable JavaScript for every website?

No. When you enable JavaScript in your browser settings, it applies to all websites you visit. You do not need to turn it on separately for each site. If you blocked CasaOS specifically, you only need to remove that one site from the blocked list.

What if I see a message about JavaScript being required?

This message appears when your browser loads the CasaOS page but JavaScript is disabled. It means the page detected that JavaScript is off and is telling you to turn it on. Follow the steps above for your browser, refresh the page, and the message should disappear.