JavaScript must be enabled in CasaOS for most apps and features to work
CasaOS is a home server operating system that runs on devices like Raspberry Pi or old computers. JavaScript is a programming language that runs inside your web browser to make interactive features work — things like buttons that respond when ready, forms that validate what you type, and apps that update without reloading the page. If JavaScript is disabled in CasaOS, many of its built-in apps and dashboard features will not function properly.
The good news is that JavaScript is enabled by default in CasaOS. You only need to change this setting if you or someone else deliberately turned it off, or if you are troubleshooting a problem where an app stopped working after a browser or system update.
Key Takeaways
- JavaScript is enabled by default in CasaOS and controls interactive features like app dashboards and system controls.
- If an app or feature is not responding to clicks or appears broken, JavaScript may have been disabled in your browser settings.
- You enable JavaScript through your web browser's settings, not through CasaOS itself, because CasaOS runs inside your browser.
- Different browsers store this setting in different places — Chrome, Firefox, Safari, and Edge each have their own menu path.
- After enabling JavaScript, close and reopen your browser tab to CasaOS for the change to take effect.
Where JavaScript settings live in your browser
CasaOS itself does not have a JavaScript on/off switch. Instead, JavaScript is controlled by the web browser you use to access CasaOS — whether that is Chrome, Firefox, Safari, or Edge. When you visit your CasaOS dashboard (usually at an address like 192.168.1.100:80 or a local domain name), your browser decides whether to run the JavaScript code that makes the interface work.
This matters because you might have CasaOS running perfectly on your home server, but if your browser has JavaScript disabled, you will see a broken or unresponsive dashboard. The fix is not on the server — it is in your browser settings on the device you are using to access CasaOS.
How to enable JavaScript in Chrome
Open Chrome and click the three vertical dots in the top right corner. Select Settings from the menu. On the left side, click Privacy and security, then click Site settings. Scroll down and click JavaScript. You will see a toggle labeled Allowed (recommended) — make sure it is turned on (the toggle should be blue and switched to the right).
If you see a section called Block with a list of websites, check whether your CasaOS address is listed there. If it is, click the three dots next to it and select Remove. Then go back to your CasaOS tab and refresh the page by pressing Ctrl+R (or Cmd+R on Mac).
How to enable JavaScript in Firefox
Open Firefox and type about:config in the address bar. Press Enter. Firefox will show a warning — 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.
Firefox also allows you to block JavaScript on specific sites. To check this, click the menu button (three horizontal lines) in the top right, select Settings, then Privacy & Security. Scroll to Permissions and look for JavaScript. If your CasaOS address is listed under blocked sites, click the X next to it to remove the block.
How to enable JavaScript in Safari
Open Safari and click Safari in the top menu bar, then select Settings (or Preferences on older versions). Click the Security tab. Look for a checkbox labeled Enable JavaScript — it should be checked. If it is not checked, click it to enable JavaScript.
Safari does not have a per-site JavaScript block list like Chrome and Firefox, so if JavaScript is enabled globally in Safari settings, it will work on CasaOS. After enabling it, close and reopen your CasaOS tab to explore the change.
How to enable JavaScript in Microsoft Edge
Open Edge and click the three dots in the top right corner. Select Settings. On the left side, click Privacy, search, and services. Scroll down to Site permissions and click JavaScript. Make sure the toggle for Allowed (recommended) is turned on (blue and switched right).
Check the Block section below to see if your CasaOS address is listed. If it is, click the three dots next to it and select Remove. Refresh your CasaOS tab with Ctrl+R to load the page with JavaScript enabled.
What to do if CasaOS still does not work after enabling JavaScript
If you have enabled JavaScript in your browser but CasaOS features are still not responding, try clearing your browser cache. In Chrome, Firefox, and Edge, press Ctrl+Shift+Delete (or Cmd+Shift+Delete on Mac). Select All time from the time range dropdown, check Cookies and other site data and Cached images and files, then click Clear data. In Safari, click Safari in the menu bar, select Clear History, choose All history, and click Clear History.
After clearing the cache, close the browser completely and reopen it. Navigate back to your CasaOS address. The dashboard should now load with a fresh copy of the JavaScript code. If the problem persists, the issue may be with your CasaOS installation itself rather than your browser settings — in that case, check whether your CasaOS system has internet access and whether any recent updates were interrupted.
Frequently Asked Questions
Why would JavaScript ever be disabled if it is enabled by default?
Some people disable JavaScript to improve privacy or block tracking scripts on regular websites. Others do it for security reasons on public computers. If you share a device or use a managed computer at work, someone may have disabled it. Browser updates can also occasionally reset settings, though this is rare.
Is it safe to enable JavaScript for CasaOS?
Yes. CasaOS is running on your own home network, not the public internet. Enabling JavaScript for your local CasaOS address does not expose you to the same risks as enabling it for random websites. You can safely enable JavaScript globally or just for your CasaOS address.
Do I need to enable JavaScript on every device that accesses CasaOS?
Yes. JavaScript is a browser setting, not a server setting. If you access CasaOS from your phone, tablet, laptop, and desktop computer, each device's browser needs JavaScript enabled. You only need to enable it once per browser, and it will stay enabled unless you change it again.
What if I do not know my CasaOS address?
Check your router's connected devices list, or look at the screen or display connected to the device running CasaOS. The address usually appears as an IP address like 192.168.1.100 or a local domain name like casaos.local. If you set up a custom domain during installation, use that address instead.
Can I use CasaOS without JavaScript?
No. CasaOS relies on JavaScript for nearly all of its interactive features. Without it, you will see a blank or broken dashboard and will not be able to install apps, manage storage, or control system settings. JavaScript must be enabled for CasaOS to function.