Fleet logo
Menu An icon indicating that interacting with this button will open the navigation menu.
Fleet logo An 'X' icon indicating that this can be interacted with to close the navigation menu.
Multi platform
Device management   (+ MDM) Orchestration   (+ monitoring) Software management   (+ CVEs) Integrations

Docs
Stories
News Ask around Share your story COMPANY
The handbook What people are saying

Pricing Schedule a demo
Multi platform
Device management + MDM Orchestration + monitoring Software management + CVEs, usage, app library Integrations
Docs
Stories
News Ask around Schedule a demo Share your story COMPANY The handbook What people are saying
Pricing Try it yourself
click to open the table of contents.

Upgrading Fleet

Upgrading Fleet

Edit page

{{page.title}}

{{subpage.title}}
Get your license Contribute Release notes Support Take a tour “Why is Fleet on my computer?”
A very nice Fleet branded shirt

Request Fleet swag

It's free right arrow

On this page:

{{subtopic.title}}
A very nice Fleet branded shirt

Request Fleet swag

It's free right arrow

On this page

click to open the table of contents

Upgrading Fleet

This guide explains how to upgrade your Fleet instance to the latest version in order to get the latest features and bug fixes. For initial installation instructions, see Installing Fleet.

There are four steps to perform a typical Fleet upgrade:

  1. Bringing Fleet offline
  2. Installing the latest version
  3. Preparing the database
  4. Serving the new Fleet instance

Bring Fleet offline

In order to avoid any errors while preparing the database for the new version of Fleet, all Fleet instances need to be shut down during the migration process. During a typical upgrade, you can expect 5-10 minutes of downtime.

An icon indicating that this section has important information

Your hosts will buffer any logs generated during this time and send those buffered logs once the server is brought online again.

Install the latest version of Fleet

Fleet may be installed locally, or used in a Docker container. Follow the appropriate method for your environment.

Local installation

Download the latest version of Fleet. Check the Upgrading section of the release notes for any additional steps that may need to be taken for a specific release.

Unzip the newly downloaded version, and replace the existing Fleet version with the new, unzipped version.

For example, after downloading:

unzip fleet.zip 'linux/*' -d fleet
sudo cp fleet/linux/fleet* /usr/bin/

Docker container

Pull the latest Fleet docker image:

docker pull fleetdm/fleet

Prepare the database

Changes to Fleet may include changes to the database. Running the built-in database migrations will ensure that your database is set up properly for the currently installed version.

It is always advised to back up the database before running migrations.

Database migrations in Fleet are intended to be run while the server is offline. Osquery is designed to be resilient to short downtime from the server, so no data will be lost from osqueryd clients in this process. Even on large Fleet installations, downtime during migrations is usually only seconds to minutes.

Run database migrations:

fleet prepare db

Serve the new version

Once Fleet has been replaced with the newest version and the database migrations have completed, serve the newly upgraded Fleet instance:

fleet serve

AWS with Terraform

If you are using Fleet's Terraform modules to manage your Fleet deployment to AWS, update the version in main.tf:

  fleet_config = {
    image = "fleetdm/fleet:<version>" 
    [...]
  }

Run terraform apply to apply the changes.

Try it out

See what Fleet can do

Start now

An arrow pointing upBack to top

{{page.title}}

{{subpage.title}}
Get your license Contribute Release notes Support Take a tour “Why is Fleet on my computer?”

On this page:

{{subtopic.title}}
Fleet logo
Multi platform Device management Orchestration Software management Integrations Pricing
Documentation Support Docs API Release notes Get your license
Company About News Jobs Logos/artwork Why open source?
ISO 27001 coming soon a small checkmarkSOC2 Type 2 Creative Commons Licence CC BY-SA 4.0
© 2025 Fleet Inc. Privacy
Slack logo GitHub logo LinkedIn logo X (Twitter) logo Youtube logo Mastadon logo