Quick Start

1. Prepare your account

Open the Palladin panel for your environment. If you do not have an account, register and complete account setup. Sign in and check that you can open Agents and add an agent in your organization.

2. Install the CLI

Install the CLI where your agent runs — on your computer or its server.

In a terminal with Node.js 20.5.0 or newer and npm 9.7.1 or newer installed, run:

npm install --global @palladin/cli

In a terminal in that same environment, run:

palladin --version
palladin doctor

We recommend Hardened protection. Check the mode reported by doctor and availability on your platform.

If the terminal cannot find palladin or doctor reports an error, resolve it before pairing. See installation troubleshooting.

3. Pair the agent with your panel

1. In the panel, open Agents and select the + button (“Add Agent”) above the list.
2. Copy the generated message and give it to your agent. It contains your environment configuration and a link to the connection instructions.
3. The agent starts pairing. Open the indicated page and approve the connection in your panel.
4. Check that the agent appears in the panel. In the terminal, confirm its status using the selected profile name:

palladin --id <profile> status

Do not give the agent your account password or recovery key. Pairing registers the agent; you approve access to data separately.

See the installation guide for configuration details.

What next?

Test access using a non-secret test entry. If your application uses MCP, add the Palladin server.