> ## Documentation Index
> Fetch the complete documentation index at: https://docs.panofx.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Command reference

> Every panofx-node command and flag.

```
panofx-node <command>
```

Secrets come from the environment, never the policy: see [Node environment](/reference/node-environment).
On Windows every command runs as `.\panofx-node.exe <command>`.

## The app

| Command                                                                                 | What it does                                                                                                                                                       |
| --------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `app [--data-dir DIR] [--addr 127.0.0.1:47800] [--open=false] [--remote auto\|on\|off]` | The point-and-click node: setup, pricing, alerts, no YAML. `--remote auto` (default) turns the remote console on while a browser is paired or a pairing link waits |
| `remote pair [--data-dir DIR]`                                                          | Print a fresh pairing link for a node you cannot open                                                                                                              |
| `remote devices [--data-dir DIR]`                                                       | List paired browsers                                                                                                                                               |
| `remote revoke ID [--data-dir DIR]`                                                     | Revoke one, and the devices it paired                                                                                                                              |

The default data directory is `~/Library/Application Support/Panofx` on macOS, `%AppData%\Panofx` on
Windows and `~/.config/panofx` on Linux, or `PANOFX_DATA_DIR`.

## Keys

| Command                                                                    | What it does                                                                                                                |
| -------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
| `init --keyfile PATH [--solana]`                                           | Create a new encrypted keyfile, EVM or Solana. Never overwrites. Prints the address                                         |
| `keys import --keyfile PATH --private-key K [--solana] [--keypair-file F]` | Import an existing key (dev or migration). With `--solana`, `K` is a base58 secret key, or pass a solana-keygen file as `F` |
| `keys export --keyfile PATH`                                               | Print the address and the encrypted keyfile, for backup                                                                     |

## Policy and setup

| Command                              | What it does                                                                                                                                    |
| ------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| `policy validate --policy PATH`      | Check a policy file; errors carry line numbers                                                                                                  |
| `signer test --policy PATH`          | Open the signers, sign a message and a real offer, verify both, report latency. Over 700 ms is too slow                                         |
| `approve --policy PATH [--dry-run]`  | One-time setup on every chain: Permit2 approvals on EVM chains (needs a little ETH), token accounts on Solana (a little SOL). Idempotent        |
| `register --policy PATH [--api URL]` | Prove control of the signer to the relay and register the name, region and alert email. `--api` overrides the HTTP URL derived from `relay_url` |

## Run

| Command                          | What it does                                                   |
| -------------------------------- | -------------------------------------------------------------- |
| `start --policy PATH`            | Run the node                                                   |
| `status [--addr 127.0.0.1:8787]` | State, chains and inventory of a running node                  |
| `pause [--addr …]`               | Stop quoting at once; open offers stay valid until they expire |
| `resume [--addr …]`              | Start quoting again                                            |
| `version`                        | Print the version                                              |

`status`, `pause` and `resume` talk to the local control endpoint at the policy's `metrics_addr`.