Fleet documentation

Welcome to the documentation for Fleet, an open-source osquery management server.

Install Fleet

Install osquery and Fleet

Get started right arrow
Fleet support

Can't find what you need?

Support right arrow



Releasing Fleet

Note: Please prefix versions with fleet-v (eg. fleet-v4.0.0) in git tags, Helm charts, and NPM configs.

  1. Update the CHANGELOG with the changes that have been made since the last Fleet release. Use make changelog to pull the changes files into CHANGELOG.md, then manually edit. When editing, order the most relevant/important changes at the time, and try to make the tone and syntax of the written language match throughout. make changelog will stage all changes file entries for deletion with the commit.

Update the NPM package.json with the new version number (do not yet npm publish). Update the Helm chart and values file with the new version number.

Commit these changes via Pull Request and pull the changes on the main branch locally. Check that HEAD of the main branch points to the commit with these changes.

  1. Tag and push the new release in Git:
git tag fleet-v<VERSION>
git push origin fleet-v<VERSION>

Note that origin may be upstream depending on your git remote configuration. The intent here is to push the new tag to the github.com/fleetdm/fleet repository.

GitHub Actions will automatically begin building the new release after the tag is pushed.

Wait while GitHub Actions creates and uploads the artifacts...

When the Actions Workflow has completed:

  1. Edit the draft release on the GitHub releases page. Use the version number as the release title. Use the below template for the release description (replace items in <> with the appropriate values):
### Changes


### Upgrading

Please visit our [update guide](https://github.com/fleetdm/fleet/blob/main/docs/1-Using-Fleet/8-Updating-Fleet.md) for upgrade instructions.

### Documentation

Documentation for this release can be found at https://github.com/fleetdm/fleet/blob/<VERSION>/docs/README.md

### Binary Checksum

<!-- __LANG=%%__ -->
<COPY FROM checksums.txt>
<!-- __LANG=%%__ -->

When editing is complete, publish the release.

  1. Publish the new version of fleetctl on NPM. Run npm publish in the fleetctl-npm directory. Note that NPM does not allow replacing a package without creating a new version number. Take care to get things correct before running npm publish!

If releasing a "prerelease" of Fleet, run npm publish --tag prerelease. This way, you can publish a prerelease of fleetctl while the most recent fleetctl npm package, available for public download, is still the latest official release.

  1. Announce the release in the #fleet channel of osquery Slack and update the channel's topic with the link to this release. Using @here requires admin permissions, so typically this announcement will be done by @zwass.

Announce the release via blog post (on Medium) and Twitter (linking to blog post).

Is there something missing?

If you notice something we’ve missed, or that could be improved, please click here to edit this page.