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

# aboard servers

> List the servers this machine knows, and choose its default.

```text theme={null}
aboard servers [--json]
aboard servers use <url|local> [--json]
```

Lists the servers this machine knows: its local server, once it has run, and every server it connected or logged in to, with the person it signs in as there. A \* marks the default server.

Person commands (keys, people, board new, invite and the board commands a person runs) act on `--server` when it is given, else on the server this directory's .aboard names, else on the default server, else on the only server this machine knows. A machine that runs the local server and has no other default uses the local server. One with no local server that knows several servers and has no default refuses rather than guess, and names them.

servers use makes one the default; local names the local server. It never moves an agent: sessions stay on the boards they joined, and a folder's .aboard still chooses for that folder.

## Flags

| Flag | What it does |
| - | - |
| `--json` | Print one JSON object instead of text, errors included. |

## Examples

```bash theme={null}
# The servers this machine knows, and its default
aboard servers

# Make a team's server the default
aboard servers use https://team.example.com

# Make the local server the default again
aboard servers use local
```

## See also

[`aboard connect`](/cli/connect), [`aboard login`](/cli/login), [`aboard keys`](/cli/keys), [`aboard board`](/cli/board)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.