---
title: Sitios y servidores del panel
description: Lista y consulta solo tus sitios y servidores propios desde la CLI.
sidebar:
  label: Sitios y servidores
  order: 2
---

Lectura de solo escritura nula sobre la cuenta conectada. Los sitios locales (`plak list`) y los recursos del panel nunca se mezclan: todo aquí habla explícitamente de datos del panel y se resuelve con la conexión guardada por [`plak connect`](/cli/connect).

```bash
plak panel sites [--page N] [--per-page N] [--all] [--json]
plak panel site <id|dominio> [--json]
plak panel servers [--page N] [--per-page N] [--all] [--json]
plak panel server <id|nombre> [--json]
```

## Paginación y selección

- `--page N` y `--per-page N` (1–100, por defecto 25). `--all` recorre todas las páginas para inventarios y automatizaciones.
- La selección acepta un id numérico (consulta directa) o el dominio/nombre **exacto** (recorre páginas, hasta 10).
- `--json` devuelve la respuesta sin el secreto.

```bash
plak panel sites --all
plak panel site ejemplo.com
plak panel servers --all --json
plak panel server 7
```

Requiere los endpoints personales `GET /api/v1/sites`, `/sites/{id}`, `/servers` y `/servers/{id}` (alcance `user:read`). Un id ajeno resuelve a `404` en el servidor: los recursos de otras cuentas no se listan ni son enumerables desde aquí.

## Seguridad de origen

El token guardado jamás se envía a otro origen. `--panel URL` o `--dev` en un comando `panel` se rechazan: para cambiar de panel, reconecta primero.

```bash
# No hace esto: reutilizar la credencial en otro origen
plak connect --panel https://panel.otro.example
plak panel sites
```

## Estados

- Cuenta vacía: `No sites yet` / `No servers yet` (salida `0`).
- Token inválido, revocado o caducado: apunta a `plak connect` para reconectar.
- Cuenta bloqueada: se informa como tal.
- Sin conexión: `Not connected. Run: plak connect`.

:::note
Las escrituras (crear servidores o sitios, operar WordPress, firewall o infraestructura) viven en [operaciones del panel](/cli/operaciones) y requieren scopes opt-in `servers:write`/`sites:write`. El emparejamiento aprobado por defecto trae lectura + SSH.
:::

 Continúa con [vinculación y migraciones](/cli/vincular) para usar un sitio del panel con `push`/`pull`, o con la [referencia de la API](/api) para el contrato HTTP.
