---
title: Instalación
description: Instala Plak CLI con Homebrew o con el instalador, y prepara la pila local.
sidebar:
  label: Instalación
  order: 0
---

Dos pasos: primero el binario `plak`, después la pila local (`plak install`).

## 1. Instala el binario

**Instalador**

Funciona en macOS y Linux. Instala en `/usr/local/bin` (en Apple Silicon con Homebrew, en `/opt/homebrew/bin`); pide `sudo` solo si el destino no es escribible.

```bash
curl -fsSL https://plak.sh/install | bash
```

Variables opcionales: `PLAK_INSTALL_DIR` para cambiar el destino y `PLAK_INSTALL_URL` para otra fuente del script.

**Homebrew**

```bash
brew install plakio/tap/plak-cli
```

O tocando el tap primero:

```bash
brew tap plakio/tap
brew install plak-cli
```

Comprueba que quedó disponible:

```bash
plak version
```

## 2. Prepara la pila local

```bash
plak install
plak status
```

`plak install [--yes]` instala o guía la instalación de las dependencias con el gestor nativo de cada sistema (Homebrew en macOS, apt/dnf en Linux, con descarga directa como respaldo): `gum`, FrankenPHP y sus extensiones PHP para WordPress, MariaDB, Mailpit, WP-CLI y `wp-mcp-cli`. Después crea la estructura en `~/Plak`, configura MariaDB, levanta los servicios y confía el certificado local.

- Sin TTY (CI, scripts) se comporta como `--yes` para no quedarse esperando.
- Si los puertos 80/443 están ocupados, ofrece alternativas (8090/8453) o puertos personalizados.
- En WSL avisa si falta `systemd` y al final recuerda ejecutar `plak wsl-hosts` para las entradas del archivo hosts de Windows.

`plak status [--json]` verifica dependencias y rutas sin cambiar nada. `plak upgrade [--yes]` actualiza la pila local.

## Requisitos

| Necesidad | Detalle |
| --- | --- |
| Sistema | macOS o Linux (con detección de WSL) |
| Shell | Bash |
| Red | `curl` para el instalador y las conexiones al panel |
| Clave SSH | `ssh` y `ssh-keygen` para remotos y vinculaciones |
| Pila local | `gum`, FrankenPHP, MariaDB/MySQL, Mailpit y WP-CLI (los instala `plak install`) |
| Permisos | `sudo` para escribir `/etc/hosts` y arrancar servicios en Linux |

`curl` + `python3` son además lo único que necesitan `plak connect` y `plak panel` (cliente HTTP con parser JSON real).

## Habilidades para agentes

```bash
plak skill install
```

Instala la skill para el agente detectado. Para uno concreto o todos:

```bash
plak skill install codex
plak skill install claude-code
plak skill install opencode
plak skill install hermes
plak skill install pi
plak skill install global
plak skill install all
```

`all` instala en cada agente (`codex`, `claude-code`, `opencode`, `hermes`, `pi`); `global` usa `~/.agents/skills`.

## Siguiente paso

Crea tu primer sitio y abre el dashboard:

```bash
plak add mi-sitio
open https://plak.localhost
```

Continúa en [Conexión con el panel](/cli/connect) para vincular tu cuenta, o en [Sitios locales](/cli/sitios) para el flujo diario.