Installation / migration / operations

Install, migrate and operate CitusIO.

Deploy one CitusIO image on your infrastructure. Use the installation, migration and operations skills with your preferred agent.

Installation

Install a node.

container-setup/SKILL.md

Extract the image’s requirements and deployment files.

docker run --rm darkanchor/citusio:1.30 requirements
docker run --rm darkanchor/citusio:1.30 deployment > deployment.tar
mkdir deployment
tar -xf deployment.tar -C deployment

Free image shown. Use the image and version for your tier.

Add the required credentials and service connections to the extracted deployment. Validate the configuration and start the node using the installation skill.

Verify node readiness, allowed and denied MQTT access, and delivery to your configured destination.

Migration

Migrate from Mosquitto or EMQX.

Mosquitto skill
EMQX skill
Cutover and rollback

Inventory the source configuration, clients, topics, credentials and retained/session state. The migration skills map these requirements to your selected CitusIO tier and identify compatibility gaps.

Test a separate candidate with your traffic and state requirements. Verify delivery and recovery, then follow the cutover skill to move traffic with a rollback plan.

Operations

Operate and recover a node.

Node operations
Panel operation
Direct HTTP operation

Use Overview, Triage and Command Center in the panel, or the admin API with your agent.

GET /api/v1/admin/identity
GET /api/v1/admin/dashboard

Check the node’s identity and readiness before making a change. Track each command to completion through its command ID. Use command status to recover a lost response.