fleet/articles/gitops-mode.md
Eric 7ca5306edf
Website: update article image filenames to match website naming conventions (#32263)
Related to: [#25943](https://github.com/fleetdm/fleet/issues/25943)

Changes:
- Updated filenames of images in the website/assets/images/articles/
folder to match website naming conventions
- Updated links to images in articles.
2025-08-25 12:47:33 -05:00

34 lines
1.6 KiB
Markdown

# GitOps mode
GitOps mode helps users avoid unexpected changes by preventing manual updates of [GitOps-configurable features](https://fleetdm.com/docs/configuration/yaml-files) in the UI.
For example, if a user in the Fleet UI adds a query and then GitOps runs, the query will be deleted.
GitOps mode helps avoid this by preventing the user from saving or editing the query in the first place
(though does still allow running an ad-hoc live query):
![](../website/assets/images/articles/gitops-mode-disables-saving-queries-900x480@2x.png)
## Enabling
To turn GitOps mode on or off, navigate to **Settings** > **Integrations** > **Change management**:
![](../website/assets/images/articles/enabling-gitops-mode-960x594@2x.gif)
## Still available
GitOps mode prevents the UI user from editing [GitOps-configurable features](https://fleetdm.com/docs/configuration/yaml-files). They will still be able to, for example:
- Read any data presented in the UI
- Add and edit users
- Add and edit labels
- Run live queries
## More
<!-- TODO - update to link to Allen's article, uncomment -->
<!-- - [Why use GitOps to configure Fleet?](https://www.example.com) -->
- [Preventing Mistakes with GitOps](https://fleetdm.com/guides/preventing-mistakes-with-gitops)
<meta name="articleTitle" value="GitOps mode">
<meta name="authorFullName" value="Jacob Shandling">
<meta name="authorGitHubUsername" value="jacobshandling">
<meta name="publishedOn" value="2025-03-21">
<meta name="category" value="guides">
<meta name="description" value="Help users avoid unexpected changes by preventing manual updates of GitOps-configurable features">