Manage bootstrap packages with GitOps

Bootstrap packages let you install custom software during device enrollment. This guide shows you how to manage them through GitOps using Fleet's API.

Note: Each team needs its own bootstrap package. Teams can't share bootstrap packages.

Prerequisites

Before you start, you'll need:

• A Fleet GitOps setup with an API-only user account
• Access to Fleet's API endpoints
• A bootstrap package ready to upload

Upload the bootstrap package

First, upload your bootstrap package to each team that needs it.

You can use either:

• The Fleet UI to upload the package manually
• The Create bootstrap package API endpoint to upload programmatically

Repeat this step for every team that needs the package.

Get the bootstrap package token

After uploading, retrieve the unique token for each team's bootstrap package.

Use the Get bootstrap package metadata API endpoint. The response includes the token you'll need for the next step.

Configure your GitOps team file

In each team's YAML configuration file, add the bootstrap_package field with the download URL:

bootstrap_package: "https://your-fleet-instance.com/api/v1/fleet/bootstrap?token=your-token-here"

Replace your-fleet-instance.com with your Fleet instance domain and your-token-here with the token from the previous step.

More information

Learn more about bootstrap packages and setup experiences in the setup experience guide.