Update Coreflux when a new release includes fixes or features you need. Check Release Notes for what changed in each version.
Keep your project files. Docker named volumes and binary install directories retain LoT, routes, and configuration when you stop the broker and replace only the runtime.
Cloud Trial environments are managed by Coreflux. When an update is available, your trial instance is upgraded on the hosted side—you do not run install or update commands locally.
Continue using the URL and credentials from your trial email. If the HUB or MQTT client fails right after a platform update, wait up to 60 seconds and reconnect—the broker may still be restarting.
See Release Notes for new features you can use once the trial environment is on the latest version.
To run the latest image, stop and remove the existing container, then start a new one with the same docker run command from Installation. The --pull=always flag ensures Docker fetches the newest latest tag before each start.
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.
If you use TLS ports, use the command from the TLS/SSL accordion on Installation—still with --pull=always, the same container name, and the same project-volume mount.
3
Verify
Open the Coreflux HUB 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.
Coreflux on a DigitalOcean droplet runs as a systemd service. SSH into the droplet and replace the broker binary, then restart the service.
Use your actual paths and service name. Marketplace images typically use the coreflux systemd unit and install under /opt/coreflux. Adjust commands if you changed these during setup.
1
Connect to the droplet
ssh root@<your-droplet-ip>
2
Stop the broker
sudo systemctl stop coreflux
3
Download and replace the binary
Download the latest Linux build from coreflux.org/start-for-free, extract it, and replace CorefluxMQTTBroker in your install directory (for example /opt/coreflux). Keep existing configuration and project files in that directory.
4
Start the broker
sudo systemctl start corefluxsudo systemctl status coreflux
Update a Windows service install by stopping the service, replacing the executable, and starting it again.
Use your actual service and paths. Examples use the service name CorefluxBroker and install path C:\Coreflux. Change these if you registered the service differently—see Installation.
1
Stop the service
Open Command Prompt as Administrator and run:
sc stop CorefluxBroker
2
Replace the executable
Download the latest Windows zip from coreflux.org/start-for-free, extract it, and copy CorefluxMQTTBroker.exe over the file in your install folder (for example C:\Coreflux). Do not remove your existing config or project files in that folder.
3
Start the service
sc start CorefluxBrokersc query CorefluxBroker
Foreground
systemd service
If you run the broker directly (not as a service):
1
Stop the broker
Stop the running process (Ctrl+C in the terminal where CorefluxMQTTBroker is running).
2
Replace the binary
Download the latest Linux zip from coreflux.org/start-for-free, extract it, and replace CorefluxMQTTBroker in your install directory. Keep your existing config and project files.
3
Start the broker
cd corefluxchmod +x CorefluxMQTTBroker./CorefluxMQTTBroker
For production installs using systemd (see Installation):
Use your actual paths. Examples assume WorkingDirectory=/opt/coreflux and service name coreflux. Adjust if your unit file differs.
1
Stop the service
sudo systemctl stop coreflux
2
Replace the binary
Download the latest Linux zip from coreflux.org/start-for-free, extract it, and replace CorefluxMQTTBroker under your service working directory (for example /opt/coreflux).
3
Start the service
sudo systemctl start corefluxsudo systemctl status coreflux
Foreground
systemd service
If you run the broker directly (not as a service):
1
Stop the broker
Stop the running process (Ctrl+C in the terminal where CorefluxMQTTBroker is running).
2
Replace the binary
Download the latest Raspberry Pi zip from coreflux.org/start-for-free, extract it, and replace CorefluxMQTTBroker in your install directory. Keep your existing config and project files.
3
Start the broker
cd corefluxchmod +x CorefluxMQTTBroker./CorefluxMQTTBroker
For production installs using systemd (see Installation):
Use your actual paths. Examples assume WorkingDirectory=/home/pi/coreflux and service name coreflux. Adjust if your unit file differs.
1
Stop the service
sudo systemctl stop coreflux
2
Replace the binary
Download the latest Raspberry Pi zip from coreflux.org/start-for-free, extract it, and replace CorefluxMQTTBroker under your service working directory (for example /home/pi/coreflux).
3
Start the service
sudo systemctl start corefluxsudo systemctl status coreflux
