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

# Instalación

> Instalar GOWA con Docker, Docker Compose, un binario de liberación o desde el código fuente, y ejecutarlo detrás de un proxy inverso.

![GOWA Despliegue y Acceso Resumen](https://mintcdn.com/gowa-docs/xwa06XWUO2vnG9_f/images/GOWA-Deployment-and-Access-Overview.png?fit=max\&auto=format\&n=xwa06XWUO2vnG9_f\&q=85\&s=dc847e074e7578d3cfb8c83f1d756040)

GOWA viene como un binario. El API REST, webhooks, dashboard y endpoint MCP empiezan con `whatsapp rest`.

## Requisitos

| Objeto | Necesario para |
| - | - |
| FFmpeg | Conversión multimedia (vídeo, notas de voz). Incluye en la imagen Docker. |
| libwebp tools (`cwebp`, `dwebp`, `webpmux`) | Stickers, incluyendo WebP animado. Incluye en la imagen Docker. |
| Ir 1.26+ | Construyendo solo desde fuente. |

Plataformas soportadas: Linux (amd64, arm64, armv7, 386), macOS (Intel, Apple Silicon), Windows (amd64, 386; WSL recomendado).

## Doctor

Las imágenes se publican en Docker Hub y GHCR:

* `aldinokemal2104/go-whatsapp-web-multidevice`
* `ghcr.io/aldinokemal/go-whatsapp-web-multidevice`

```bash theme={null}
docker volume create gowa_storages
docker volume create gowa_statics

docker run -d --name gowa --restart always \
  -p 3000:3000 \
  -v gowa_storages:/app/storages \
  -v gowa_statics:/app/statics \
  -e APP_BASIC_AUTH=admin:changeme \
  aldinokemal2104/go-whatsapp-web-multidevice:latest
```

* `/app/storages` contiene las bases de datos SQLite (sesiones, historial de chat, programas, OAuth). Perderlas desemparejan cada dispositivo.
* `/app/statics` contiene imágenes QR, subidas y medios descargados.
* El comando predeterminado es `rest`. Pasar las banderas después de ella, por ejemplo `... go-whatsapp-web-multidevice rest --autoreply="Away"`.
* El punto de entrada corrige la propiedad del volumen y deja caer los privilegios a `gowauser` (UID 20001, GID 20000).
* El tiempo del contenedor es UTC (`TZ=UTC`). Reemplaza `TZ` si necesitas marcas de tiempo de registro locales.

### Componer Docker

```yaml docker-compose.yml theme={null}
services:
  gowa:
    image: aldinokemal2104/go-whatsapp-web-multidevice:latest
    container_name: gowa
    restart: always
    ports:
      - "3000:3000"
    environment:
      APP_BASIC_AUTH: admin:changeme
      WHATSAPP_WEBHOOK: https://example.com/wa-hook
      WHATSAPP_WEBHOOK_SECRET: ${WHATSAPP_WEBHOOK_SECRET}
    volumes:
      - gowa_storages:/app/storages
      - gowa_statics:/app/statics

volumes:
  gowa_storages:
  gowa_statics:
```

Genera una clave web estable con `openssl rand -hex 32` y establece `WHATSAPP_WEBHOOK_SECRET` en tu shell o Componer `.env` antes de comenzar este ejemplo.

El propio repositorio `docker-compose.yml` construye la imagen desde `docker/golang.Dockerfile` y lee `src/.env`. Úsalo cuando quieras construir localmente: `cp src/.env.example src/.env && docker compose up -d --build`.

## Liberar binario

Descarga un archivo de [GitHub Releases](https://github.com/aldinokemal/go-whatsapp-web-multidevice/releases/latest). Los archivos se llaman `whatsapp_<version>_<os>_<arch>.zip`, por ejemplo:

```bash theme={null}
curl -fLO https://github.com/aldinokemal/go-whatsapp-web-multidevice/releases/download/v9.9.0/whatsapp_9.9.0_linux_amd64.zip
unzip whatsapp_9.9.0_linux_amd64.zip
chmod +x whatsapp
./whatsapp rest --basic-auth=admin:replace-with-a-strong-password
```

Instalar las herramientas multimedia en el host:

```bash theme={null}
# Debian/Ubuntu
sudo apt install ffmpeg webp
# macOS
brew install ffmpeg webp
```

Verifique la descarga contra `checksums.txt` de la misma versión. `./whatsapp version` imprime la versión; `./whatsapp --help` muestra cada bandera.

## Desde la fuente

```bash theme={null}
git clone https://github.com/aldinokemal/go-whatsapp-web-multidevice.git
cd go-whatsapp-web-multidevice/src
cp .env.example .env    # optional
go build -o whatsapp
./whatsapp rest --basic-auth=admin:replace-with-a-strong-password
```

En macOS también `export CGO_CFLAGS_ALLOW="-Xpreprocessor"` antes de construir.

### ARM sin una toolchain C

La etiqueta de construcción `purego` selecciona un controlador pure-Go SQLite para que pueda compilar de forma cruzada con CGO deshabilitado:

```bash theme={null}
# Raspberry Pi 2/3/4 (ARMv7)
CGO_ENABLED=0 GOOS=linux GOARCH=arm GOARM=7 go build -tags purego -o whatsapp-armv7
# Raspberry Pi Zero/1 (ARMv6)
CGO_ENABLED=0 GOOS=linux GOARCH=arm GOARM=6 go build -tags purego -o whatsapp-armv6
```

## Almacenamiento

Por defecto todo es SQLite bajo `storages/`:

| Datos | Por defecto | Ajustes |
| - | - | - |
| Sesiones y claves de WhatsApp | `file:storages/whatsapp.db` | `DB_URI` |
| Caché de claves de sesión (opcional, separado DB) | uses `DB_URI` | `DB_KEYS_URI` |
| Historial de chat, registro de dispositivos, programas | `file:storages/chatstorage.db` | no configurable |
| Clientes y tokens MCP OAuth | `file:storages/oauth.db` | `MCP_OAUTH_DB_URI` |

`DB_URI` también acepta PostgreSQL, por ejemplo `postgres://user:pass@host:5432/gowa?sslmode=verify-full`. La sesión remota PostgreSQL almacena por defecto la verificación de certificados cuando no se ha establecido ningún modo TLS efectivo. La URI explícita, el entorno o la configuración TLS del servicio PostgreSQL siguen aplicándose. Vea [configuración de almacenamiento](https://gowa-docs.mintlify.site/es/configuration.md#almacenamiento).

GOWA crea archivos SQLite con permisos `0600` de solo propietario y nuevos directorios padres con `0700`. Los directorios existentes mantienen sus permisos. Copia de seguridad `storages/` (o PostgreSQL más `storages/`) para mantener emparejados dispositivos a través de reconstrucciones. Trata estas copias de seguridad como credenciales.

## Beind a un proxy inverso

Sirve GOWA bajo una subruta con `APP_BASE_PATH`, y confía en las cabeceras reenviadas por el proxy con `APP_TRUSTED_PROXIES`:

```bash theme={null}
./whatsapp rest --basic-auth=admin:replace-with-a-strong-password \
  --base-path=/gowa --trusted-proxies=10.0.0.0/8
```

```nginx theme={null}
location /gowa/ {
    proxy_pass http://127.0.0.1:3000;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;     # WebSocket at /gowa/ws
    proxy_set_header Connection "upgrade";
    proxy_set_header Host $host;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
    client_max_body_size 100m;                  # largest upload GOWA accepts
}
```

`/health` permanece en la raíz (`/health`, no `/gowa/health`) así que las sondas funcionan independientemente del camino base.

El protector de origen del navegador necesita el host público. Preservar `Host` como arriba, o enviar `X-Forwarded-Host` desde un proxy de confianza. Un dashboard alojado por separado necesita su origen exacto en `APP_TRUSTED_ORIGINS` o `APP_CORS_ALLOWED_ORIGINS`. Un comodín no autoriza mutaciones o WebSockets. Sirve el dashboard sobre HTTP o HTTPS, porque las páginas `file://` tienen un origen `null` no confiable.

El oyente por defecto se niega a iniciar sin las credenciales completas de Auth Básica. Sólo habilita `APP_ALLOW_UNAUTHENTICATED=true` cuando el proxy autentifica llamadas y los clientes no pueden eludirlas. Para desarrollo local sin autenticación, vincula `APP_HOST=127.0.0.1`.

## Verificar

```bash theme={null}
curl http://localhost:3000/health                      # OK, no auth needed
curl -u admin:changeme http://localhost:3000/app/info  # server info, no device needed
curl -u admin:changeme http://localhost:3000/devices   # registered devices
```

`/health` devuelve `OK` una vez inicializado el almacenamiento. No reporta si alguna cuenta de WhatsApp está conectada; usa `GET /devices/{device_id}/status` para eso.

## Actualizando

Copia de seguridad `storages/`, tira la nueva imagen o binario, y reinicia. Lee las [notas de lanzamiento](https://github.com/aldinokemal/go-whatsapp-web-multidevice/releases) para romper los cambios primero. Unos notables: v6 hizo obligatorio el subcomando `rest`, v7 movió binarios a archivos GoReleaser, v8 agregado multidispositivo (las llamadas con ámbito de dispositivo necesitan `X-Device-Id` una vez más de un dispositivo existe), y el modo independiente `whatsapp mcp` (`:8080/sse`) fue reemplazado por el punto final `/mcp` en el servidor REST.


## Related topics

- [Inicio rápido](https://gowa-docs.mintlify.site/es/quickstart.md)


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