Server Connections
HZN Queue Console lets you connect to multiple brokers simultaneously and switch between them instantly. Each connection is stored locally — credentials are kept in your OS keychain, never in plain text.
Adding a Server
Click Add Server (or the + icon in the server panel) to open the connection dialog.
Required fields
| Field | Description |
|---|---|
| Name | A display label for this connection (e.g. Production RabbitMQ) |
| Hostname | Full URL including scheme — e.g. http://my-broker.internal or https://my-broker.internal |
| Port | Management API port (RabbitMQ: 15672, ActiveMQ: 8161) |
| Broker Type | RabbitMQ, ActiveMQ Classic, or ActiveMQ Artemis |
| Username / Password | Management API credentials |
Optional fields
| Field | Description |
|---|---|
| Environment | Tag the server as PROD, ACC, TEST, DEV, or LOCAL. Color-coded in the UI to prevent mistakes. |
| Group | Free-text label to group related servers together in the panel |
Testing the Connection
Click Test Connection before saving. The app makes a live request to the management API and reports success or the specific error (wrong port, auth failure, network unreachable, etc.).
Broker Types
RabbitMQ 3.x / 4.x
Connects via the RabbitMQ Management HTTP API. Requires the rabbitmq_management plugin to be enabled:
rabbitmq-plugins enable rabbitmq_managementDefault management port: 15672.
ActiveMQ Classic 5.x
Connects via the ActiveMQ Web Console REST API. The Jolokia endpoint must be reachable.
Default management port: 8161.
ActiveMQ Artemis 2.x
Connects via the Artemis Management Console REST API.
Default management port: 8161.
Switching Between Servers
Click any server in the left panel to make it active. All views (queue list, message browser) update immediately to reflect the selected broker.
Editing and Deleting
Right-click a server in the panel (or click the … menu) to rename, edit credentials, or delete it. Deleting also removes the stored credentials from the OS keychain.
Security
Passwords are never written to disk in plain text. On macOS they go to Keychain, on Windows to the Windows Credential Manager, and on Linux to the secret service (Libsecret / KWallet).