> ## 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.

# Connections Manager

> Save multiple broker connections, switch between them without logging out, and secure each one with its own TLS certificates

<Frame caption="Coreflux HUB login screen listing stored connections with Reachable status and a New Connection button">
  <img src="https://mintcdn.com/coreflux/9DIExGzs82iBqQZS/images/hub-login-screen.png?fit=max&auto=format&n=9DIExGzs82iBqQZS&q=85&s=47b0addc2e30a8c12c35f7bb4b5a0832" alt="Coreflux HUB login screen with stored connections, Enter buttons, and New Connection" width="3014" height="1652" data-path="images/hub-login-screen.png" />
</Frame>

## Why Use the Connections Manager

If you work with more than one broker — a local development instance, a staging cluster, a production site — the HUB remembers each one as a saved connection instead of a single remembered URL. Pick a broker from the list to sign in, probe every saved broker for reachability before you commit, and jump between brokers from the account menu without logging out and re-entering details.

## Adding a Connection

<Steps>
  <Step title="Open New Connection">
    On the login screen, click **New Connection** in the header (or click a saved card's edit action to modify an existing one). The connection form opens in the same card.
  </Step>

  <Step title="Fill in the broker details">
    Enter a name, the **Protocol** (`mqtt://`, `mqtts://`, `ws://`, or `wss://`), **Host**, and **Port**. For a HUB and broker started together with Docker Compose, use **Host** `broker` rather than `localhost` — the HUB proxies MQTT from inside Docker.

    <Frame caption="New Connection form with protocol, host, port, and an identity's username and password">
      <img src="https://mintcdn.com/coreflux/9DIExGzs82iBqQZS/images/hub-login-setup.png?fit=max&auto=format&n=9DIExGzs82iBqQZS&q=85&s=c2c0fd5cea37165139d88dc5c47e4c03" alt="Coreflux HUB New Connection form with Local Hub, ws:// localhost port 5000 path mqtt, username root, Save connection, and Connect" width="3016" height="1654" data-path="images/hub-login-setup.png" />
    </Frame>
  </Step>

  <Step title="Add an identity">
    Add at least one identity: a username and password, or an anonymous identity if the broker allows anonymous access. A connection can hold several identities — see [Identities and Switch User](#identities-and-switch-user) below.
  </Step>

  <Step title="Test, then Save or Connect">
    Click **Test** to attempt a throwaway connection with the details you entered, without saving anything. Click **Save** to store the connection for later, or **Connect** to save and sign in immediately.
  </Step>
</Steps>

## Saved Connections

Each saved connection appears as a card on the login screen, showing its name, broker URL, and a **Reachable** status that the HUB probes automatically in the background — no need to open the connection to see whether that broker is up.

* **Favorites** — star a connection to pin it; use the **All / Starred** filter above the list to narrow the view.
* **Reorder** — drag a card to change its position in the list.
* **Enter** — pick an identity from the card's dropdown and click **Enter**, or press Enter with a card focused, to sign in.
* **Edit or delete** — open a card to change its details, or remove it entirely.

## Identities and Switch User

A single saved connection can hold more than one identity — for example a day-to-day account and an admin account on the same broker. Mark one identity as the **default** for that connection, and switch between the others from the account menu without leaving the app: open the topbar account menu and choose **Switch user** to reconnect as a different identity on the *current* broker, or **Change Broker** to reconnect to a *different* saved connection (using that connection's default identity). Both close the current session cleanly and reopen it against the new target.

## Securing a Connection with TLS

For `mqtts://` and `wss://` connections, open the connection's detail panel to attach TLS material:

* A **CA certificate**, if the broker's certificate isn't already trusted by your system.
* A **client certificate and private key**, for brokers that require mutual TLS.

Server certificate verification is on by default for secure connections; only turn it off for trusted development brokers.

<Note>
  This is separate from **route** certificate management (trust stores for OPC UA and similar routes running *on* the broker) — see the route's own Certificate Management section when you configure a [Route](/hub/routes/overview).
</Note>

## Where Credentials Are Stored

* **Desktop app** — passwords and the TLS private key are encrypted at rest using your operating system's secure storage. They are never written to the plain settings file the HUB otherwise syncs to disk.
* **Browser app** — credentials are kept for the session and are not written to disk by the HUB; use your browser's own security practices (a trusted device, a locked profile) when saving connections there.

The broker's TLS **certificate** (the public part) can still be attached to a saved connection either way, since it isn't sensitive.

***

## Next Steps

<CardGroup cols={2}>
  <Card title="Installation" icon="download" href="/latest/quick-start/installation">
    Install the broker and HUB, and make your first connection.
  </Card>

  <Card title="Managing Routes" icon="route" href="/hub/routes/overview">
    Configure routes, including per-route TLS trust stores.
  </Card>
</CardGroup>
