# Source: https://langfuse.com/self-hosting/upgrade.md

---
title: How to upgrade a self-hosted Langfuse deployment
description: Use this guide to keep your Langfuse deployment up to date. Updates between minor/patch versions can be applied automatically. For major versions, please refer to the migration guides.
label: "Version: v3"
sidebarTitle: "How to Upgrade"
---

# Upgrading a Self-Hosted Langfuse Deployment

Langfuse evolves quickly ([changelog](/changelog)) and keeping your deployment up to date is key to benefit from security, performance, and feature updates.

The Langfuse versioning and upgrade process is optimized for minimal complexity and disruption. If you ever experience any issues, please create an [issue on GitHub](/issues) or contact the maintainers ([support](/support)).

## How to upgrade

<Callout type="info">

It is recommended to be familiar with our [versioning](/self-hosting/upgrade/versioning) policy before upgrading existing deployments.

</Callout>

### Minor/Patch Versions

Updates within a major version are designed to be non-disruptive and are automatically applied. On start of the application, all migrations are automatically applied to the databases.

You can automatically use the latest version of a major release by using `langfuse/langfuse:3` and `langfuse/langfuse-worker:3` as the image tags in your deployment.

To update deployments, follow the update section in our deployment guides:

- [Local](/self-hosting/deployment/docker-compose#how-to-upgrade)
- [VM](/self-hosting/deployment/docker-compose#how-to-upgrade)
- [Docker](/self-hosting/deployment/docker-compose#how-to-upgrade)
- [Kubernetes (Helm)](/self-hosting/deployment/kubernetes-helm#how-to-upgrade)

### Major Versions

If you upgrade between major versions, please follow our migration guides:

- [v2.x.x to v3.x.x](/self-hosting/upgrade/upgrade-guides/upgrade-v2-to-v3)
- [v1.x.x to v2.x.x](/self-hosting/upgrade/upgrade-guides/upgrade-v1-to-v2)

## Release Notes

Subscribe to our mailing list to get notified about new releases and new major versions.

<ProductUpdateSignup source="self-host upgrade" className="my-3 max-w-sm" />

You can also watch the [GitHub releases](https://github.com/langfuse/langfuse/releases) for information about the changes in each version.

<Frame className="max-w-md block">
  ![Langfuse
  releases](https://static.langfuse.com/docs-legacy-gifs/github-watch-changelog.gif)
</Frame>

<span>_Watch the repository on GitHub to get notified about new releases_</span>

import { ProductUpdateSignup } from "@/components/productUpdateSignup";

## Support

If you experience any issues, please create an [issue on GitHub](/issues) or consider other [support options](/support) as part of our Enterprise offering.

Alternatively, you may consider using [Langfuse Cloud](/docs/deployment/cloud), which is a fully managed version of Langfuse. If you have questions, learn more about its security and privacy [here](/security).