> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coreflux.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Updating Your Coreflux

> Upgrade your Coreflux installation to the latest release while keeping your project data intact.

## When to Update

Update Coreflux when a new release includes fixes or features you need. Check [Release Notes](/latest/product-updates/release-notes) for what changed in each version.

<Tip>
  **Project data is preserved.** If you installed with the [Docker volume mount](/v2.0/quick-start/installation) (`project-volume:/etc/project`), your LoT, routes, and configuration survive stop/remove and a fresh container start.
</Tip>

***

## Docker

To run the latest image, stop and remove the existing container, then start a new one with the same `docker run` command from [Installation](/v2.0/quick-start/installation). The `--pull=always` flag ensures Docker fetches the newest `latest` tag before each start.

<Warning>
  **Use your actual names.** The examples below use the default container name `coreflux_broker` and volume `project-volume`. If you chose different names when you first installed, replace them in every command.
</Warning>

<Steps>
  <Step title="Stop and remove the container">
    ```bash wrap theme={"theme":"css-variables","languages":{"custom":["/languages/lot.json"]}}
    docker stop coreflux_broker
    docker rm coreflux_broker
    ```

    This stops the broker and removes the container. Named volumes (such as `project-volume`) are **not** deleted—your project files remain on disk.
  </Step>

  <Step title="Start a new container">
    Run the same command you used for installation. For the standard setup:

    ```bash wrap theme={"theme":"css-variables","languages":{"custom":["/languages/lot.json"]}}
    docker run --pull=always -d --name coreflux_broker -p 1883:1883 -p 5000:5000 -p 8080:8080 -p 8443:8443 -v project-volume:/etc/project coreflux/coreflux-mqtt-broker:latest
    ```

    If you use TLS ports, include the extra mappings from the [TLS/SSL accordion on Installation](/v2.0/quick-start/installation)—still with `--pull=always`, the same container name, and the same `project-volume` mount.
  </Step>

  <Step title="Verify">
    Open the [Coreflux HUB](/v2.0/coreflux-hub/overview) at `http://localhost:8080` (or your mapped HTTPS port) and confirm routes and LoT definitions are present. Subscribe to `$SYS/Coreflux/Version` in the Data Viewer to confirm the broker version.
  </Step>
</Steps>

***

## Next Steps

<CardGroup cols={2}>
  <Card title="Release Notes" icon="list" href="/latest/product-updates/release-notes">
    See what changed in recent releases.
  </Card>

  <Card title="Installation" icon="download" href="/v2.0/quick-start/installation">
    Full install commands for every platform.
  </Card>
</CardGroup>