|
| 1 | +--- |
| 2 | +slug: system-wide-policies |
| 3 | +title: System-Wide Policies for Enterprise Deployments |
| 4 | +authors: [borntoberoot] |
| 5 | +tags: [policies, enterprise, settings, new feature] |
| 6 | +--- |
| 7 | + |
| 8 | +NETworkManager now supports system-wide policies, giving administrators centralized control over application settings across all users on a machine. This is especially useful in enterprise environments where consistent configuration and security standards need to be enforced. |
| 9 | + |
| 10 | + |
| 11 | + |
| 12 | +<!-- truncate --> |
| 13 | + |
| 14 | +## What Are System-Wide Policies? |
| 15 | + |
| 16 | +System-wide policies allow administrators to enforce specific application settings for all users on a machine. When a policy is active, the corresponding setting is locked in the UI and displays a shield icon along with a message indicating that the setting is managed by an administrator. Users can see the enforced value but cannot change it. |
| 17 | + |
| 18 | +This ensures that critical settings — such as whether the application checks for updates at startup — remain consistent and tamper-proof across your organization. |
| 19 | + |
| 20 | +## How to Configure Policies |
| 21 | + |
| 22 | +Policies are defined in a simple `config.json` file placed in the same directory as `NETworkManager.exe`. |
| 23 | + |
| 24 | +**File location:** |
| 25 | + |
| 26 | +- **Installed version**: `C:\Program Files\NETworkManager\config.json` |
| 27 | +- **Portable version**: Same directory as `NETworkManager.exe` |
| 28 | + |
| 29 | +**Example `config.json`:** |
| 30 | + |
| 31 | +```json |
| 32 | +{ |
| 33 | + "Update_CheckForUpdatesAtStartup": false |
| 34 | +} |
| 35 | +``` |
| 36 | + |
| 37 | +A `config.json.example` file is included in the application directory for reference. Simply rename it to `config.json` and set your desired policy values. Property names follow the pattern `Section_SettingName` — see the [settings documentation](https://borntoberoot.net/NETworkManager/docs/category/settings) for available policy names. |
| 38 | + |
| 39 | +:::note |
| 40 | + |
| 41 | +The file must be named exactly `config.json`, contain valid JSON, and the application must be restarted for changes to take effect. |
| 42 | + |
| 43 | +::: |
| 44 | + |
| 45 | +## Deploying Policies |
| 46 | + |
| 47 | +You can deploy the `config.json` file using your preferred method: |
| 48 | + |
| 49 | +- **Group Policy** — Use Group Policy preferences or a startup script to copy the file to the installation directory. |
| 50 | +- **Configuration management** — Deploy via SCCM/ConfigMgr, Microsoft Intune, Ansible, or similar tools. |
| 51 | +- **Scripts** — Use PowerShell scripts or PSAppDeployToolkit for scripted deployments. |
| 52 | +- **Manual** — Hand-copy the file for small-scale rollouts. |
| 53 | + |
| 54 | +:::warning |
| 55 | + |
| 56 | +Ensure the `config.json` file has appropriate permissions so that regular users cannot modify it. On standard installations in `Program Files`, this is automatically enforced by Windows file permissions. |
| 57 | + |
| 58 | +::: |
| 59 | + |
| 60 | +## Request More Policies |
| 61 | + |
| 62 | +Additional policy options will be added in future releases. If you have specific requirements for system-wide policies in your organization, please submit a feature request via the [GitHub issue tracker](https://github.com/BornToBeRoot/NETworkManager/issues/new/choose). Your feedback helps prioritize which settings to add next. |
| 63 | + |
| 64 | +More information is available in the [official documentation](https://borntoberoot.net/NETworkManager/docs/system-wide-policies). |
| 65 | + |
| 66 | +If you find any issues or have suggestions for improvement, please open an [issue on GitHub](https://github.com/BornToBeRoot/NETworkManager/issues). |
0 commit comments