Step 2: Run ControlBird CE

Start the ControlBird CE container with a single command.

Start ControlBird

Run the following command to start ControlBird CE. This pulls the image (if not already cached) and starts the container:

docker run -d \ --name controlbird \ -p 3000:3000 \ -p 9100:9100 \ -v controlbird-data:/opt/controlbird/data \ ghcr.io/controlbird/controlbird-ce:latest

What This Does

-dRuns in the background (detached mode)
--name controlbirdNames the container for easy management
-p 3000:3000Web UI: access ControlBird in your browser
-p 9100:9100Kernel port: used by services and CLI tools
-v controlbird-data:...Persists your data across container restarts

Additional Ports

If you plan to use protocol integrations, you can expose additional ports:

  • -p 1883:1883: MQTT broker
  • -p 4840:4840: OPC UA server
  • -p 502:502: Modbus TCP server

Verify It's Running

Check that the container is up:

docker ps

You should see controlbird listed with status Up. The web UI takes a few seconds to initialize on first start.

Managing the Container

Stop

docker stop controlbird

Start Again

docker start controlbird

View Logs

docker logs -f controlbird

Remove

docker rm -f controlbird

Your data is safe in the controlbird-data volume.