Cómo instalar Rakazo en tu propio VPS
Instala Rakazo en un VPS con Node 22, pnpm, PostgreSQL y Graphile Worker en Docker Compose. Compara el sandbox, gestiona claves y calcula el tamaño real.
Qué ejecuta realmente Rakazo cuando se autoaloja
Autoalojar Rakazo significa ejecutar cinco componentes en un servidor Linux: PostgreSQL, un proceso de Graphile Worker, la API, la aplicación web y un contenedor sandbox que actúa como el ordenador de los bots. Rakazo es una alternativa de código abierto a Grok Bot, publicada por elie222 con licencia Apache 2.0. Cada bot tiene sus propias conversaciones, memoria, rutinas e historial. Comparte un Team Computer con los demás bots del espacio de trabajo, salvo que se le asigne un Private Computer. También puede crear bots homólogos o subagentes de corta duración. Si términos como memoria, subagente y llamada a una herramienta no le resultan claros en ese contexto, un recorrido gradual por el funcionamiento real de los agentes merece una tarde antes de continuar. La mayoría de los ajustes siguientes sólo tienen sentido cuando puede imaginar qué hace un bot al activarse.
Por eso este sistema debe ejecutarse en un VPS (servidor privado virtual) y no en un ordenador de escritorio. Un bot que conserva memoria y ejecuta tareas programadas debe estar accesible mientras usted duerme. Un portátil que entra en suspensión detiene la cola.
Rakazo todavía se describe como beta en octubre de 2026, aunque ya publica versiones numeradas como estables. Por tanto, considérelo una configuración operativa y no un dispositivo terminado. Toda la pila está escrita en TypeScript: React 19 y Vite para la aplicación web, Hono para la API, Postgres con Prisma, Better Auth para las cuentas y Graphile Worker para los trabajos en segundo plano. Graphile Worker almacena su cola dentro de Postgres, por lo que no es necesario ejecutar Redis ni un segundo almacén de datos. .env.example establece WAKEUP_DRIVER=graphile, lo que significa que la activación de un bot corresponde a un trabajo respaldado por Postgres. Si detiene Postgres, todas las acciones programadas de los bots se detienen también. Si prefiere crear un agente a partir de componentes en lugar de ejecutar el producto de otra persona, crear su propio agente a partir de componentes es la otra opción.
Por qué un plan de 1 GB no puede alojar esto
Cuente los procesos. Postgres es uno. La API es un proceso de Node. El worker es un segundo proceso. La aplicación web es un tercero. El supervisor del sandbox es un cuarto. Después está el equipo de los bots: de forma predeterminada, un contenedor compartido de Team Computer que contiene un escritorio gráfico de Linux, con una pantalla X y un proceso de Chrome independientes para cada bot activo.
La documentación de self-host del proyecto ya no indica el tamaño del host. La documentación de v0.3.5, consultada el 27 de octubre de 2026, sólo enumera los requisitos de software. Lo que sí indica es un límite por equipo: con los sandboxes de Docker, RAKAZO_COMPUTER_MEMORY tiene como valor predeterminado 2g y RAKAZO_COMPUTER_CPUS tiene como valor predeterminado 2. Ese límite se aplica a cada equipo, no a cada bot. Cada workspace obtiene un Team Computer de forma predeterminada, y cada Team bot activo ejecuta su escritorio y su navegador dentro de él, por lo que todos comparten esos 2 GB y dos núcleos. Sólo un bot trasladado a un Private Computer obtiene un contenedor y un límite propios. Configure SANDBOX_PROVIDER=docker y esos escritorios se ejecutarán en su VPS, además del plano de control, por lo que 4 GB es el mínimo y no un objetivo. Empiece con 8 GB si piensa mantener despierto más de un bot, aumente RAKAZO_COMPUTER_MEMORY para que el equipo compartido pueda usar realmente esa memoria y mida la cantidad real con docker stats mientras trabajan los bots. El navegador dentro del sandbox es lo que aumenta el consumo de memoria, por lo que una hoja de especificaciones no se lo indicará. Para evitar que un equipo pequeño ejecute demasiados navegadores a la vez, configure un valor positivo de SANDBOX_TEAM_SCREEN_LIMIT, que limita los escritorios activos en un Docker Team Computer. El valor incluido 0 no establece ningún límite. Si la memoria total es escasa, RAKAZO_COMPUTER_MEMORY también acepta un valor menor, como 1536m. Para conocer el método general de dimensionamiento de un equipo para ejecutar agentes, cuánta RAM y CPU necesita realmente un VPS para agentes explica la medición en detalle.
Una configuración evita que la situación empeore. .env.example incluye SANDBOX_IDLE_MS=600000, y su comentario indica que los equipos se pausan o se detienen después de esa cantidad de milisegundos inactivos. Tras diez minutos de inactividad, el equipo desaparece. El valor mínimo aceptado es 30000, y 0 desactiva la suspensión por inactividad. El mismo comentario recomienda 0 para instalaciones self-host de Docker, donde un equipo inactivo no tiene ningún coste, para que las aplicaciones y sesiones de larga duración permanezcan activas. Esto se aplica al coste, no a la memoria. En un VPS pequeño, mantenga activado el temporizador, porque sin él todos los equipos que haya iniciado y todos los navegadores que se ejecuten dentro de ellos seguirán funcionando.
El disco también cuenta. La imagen del sandbox, los módulos de Node y el volumen de Postgres comparten un mismo disco, por lo que 40 GB es un punto de partida razonable.
Fije una versión antes de clonar
Rakazo avanza rápido y main no es una versión publicada. A fecha de 9 de noviembre de 2026, v0.8.0, publicada el 4 de noviembre de 2026, es la versión marcada como Latest. Esta guía sigue fijada en v0.3.5, publicada el 25 de octubre de 2026.
git clone https://github.com/elie222/rakazo.git
cd rakazo
git checkout f31e3c0699f086d663637c4107858c238a086fb3
git log -1 --format='%H %ci'Ese commit es el que señala v0.3.5. Fije el commit en lugar de la rama o la etiqueta. Una rama cambia en el siguiente git pull, y una etiqueta es un nombre móvil que un mantenedor puede reasignar, por lo que ninguna de las dos identifica un árbol al que pueda volver. Un identificador de commit no cambia. Anótelo junto con los demás datos del servidor, porque cuando una actualización rompe algo, la solución rápida y barata es git checkout <old commit> y reconstruir, y eso sólo funciona si sabe qué commit funcionaba. El README fijado califica Rakazo como beta, por lo que merece la pena fijarlo con precisión. Un proyecto con un historial largo de versiones publicadas de forma deliberada puede fijarse en una etiqueta publicada, como hace una pila autoalojada más pequeña, como openGym.
Requisitos: Node 22, pnpm 9 y Docker
node -v
pnpm -v
docker --versionpackage.json declara "engines": { "node": "^22.22.2 || ^24.0.0 || >=26.0.0" } y "packageManager": "pnpm@9.15.0". Por tanto, node -v debe mostrar v22.22.2 o una versión 22.x posterior, cualquier v24, o v26 y posteriores. Un v22 anterior a 22.22.2 queda fuera de ese rango, y el README indica explícitamente que Node.js 23.x y 25.x no son compatibles. Instale una versión compatible de Node desde NodeSource o nvm. Corepack se incluye con Node 22 y 24. En Node 26 y posteriores, instálelo primero con npm install -g corepack. Después, active pnpm:
corepack enable
corepack prepare pnpm@9.15.0 --activateDocker Engine y el plugin compose cubren el resto. La documentación de instalación independiente requiere Docker Engine 26 o posterior y API 1.45 o posterior para usar subrutas en volúmenes del directorio principal del bot, además de curl y OpenSSL. Su usuario también debe poder acceder al daemon. Si docker ps responde permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock, añada su usuario al grupo docker y abra un nuevo shell de inicio de sesión. Comprenda primero qué permisos concede: pertenecer a docker equivale a tener root en la máquina, porque cualquier usuario de ese grupo puede iniciar un contenedor que monte el sistema de archivos del host.
Configure .env y, después, inicia Postgres
cp .env.example .env
chmod 600 .envVarios valores deben cambiar antes de iniciar cualquier servicio. .env.example incluye BETTER_AUTH_SECRET=replace-with-32-plus-character-secret, ENCRYPTION_KEY=replace-with-64-random-hex-characters, SCREEN_PROXY_SECRET=replace-with-32-plus-character-screen-proxy-secret y SANDBOX_SUPERVISOR_TOKEN=replace-with-32-plus-character-supervisor-token, y deja POSTGRES_PASSWORD y POSTGRES_APP_PASSWORD vacíos. Todos esos marcadores de posición están publicados en el repositorio. Por tanto, un despliegue que conserve uno de ellos está usando un secreto que cualquiera puede leer. Asigne a cada uno un valor aleatorio distinto. ENCRYPTION_KEY debe tener 64 caracteres hexadecimales aleatorios. Eso es exactamente lo que muestra openssl rand -hex 32. Los demás secretos requieren 32 caracteres o más. Ejecute la línea de base64 una vez para cada uno. Para las dos contraseñas de Postgres, la documentación del repositorio solicita valores seguros para URL. La última línea los genera. Ejecútela una vez para cada contraseña. La base de datos tiene dos cuentas de acceso. DATABASE_MIGRATION_URL incluye postgres://rakazo:REPLACE_WITH_POSTGRES_PASSWORD@127.0.0.1:5433/rakazo, la cuenta propietaria que ejecuta las migraciones, y DATABASE_URL incluye postgres://rakazo_app:REPLACE_WITH_POSTGRES_APP_PASSWORD@127.0.0.1:5433/rakazo, la cuenta propia de la aplicación. Esta no tiene privilegios de superusuario y está sujeta a la seguridad de nivel de fila. Coloque cada contraseña en su propia URL. pnpm db:migrate crea la cuenta rakazo_app con la contraseña que haya establecido.
openssl rand -base64 48
openssl rand -hex 32
openssl rand -hex 24Después, inicie sólo la base de datos y ejecute las migraciones.
docker compose --env-file .env -f infra/compose/docker-compose.yml -f infra/compose/docker-compose.postgres-host.yml up postgres -d
pnpm install
pnpm db:generate
pnpm db:migrate
pnpm sandbox:buildpnpm sandbox:build crea la imagen del equipo bot, definida en package.json como docker build -t rakazo/computer:local infra/sandboxes/computer. Es una imagen gráfica. Por eso, la primera compilación descarga muchos datos y tarda. Confirme que se haya creado con docker image ls rakazo/computer. El comando debería mostrar una fila.
El archivo compose base no publica ningún puerto de Postgres. El overlay docker-compose.postgres-host.yml incluido en ese comando lo publica como 127.0.0.1:5433, sólo en loopback. Así, las herramientas del host, como pnpm db:migrate y pnpm dev, pueden acceder a él. Mantenga esta configuración. Compose no inicia Postgres sin un POSTGRES_PASSWORD en .env, pero un puerto de Postgres accesible desde Internet facilita los ataques contra contraseñas. El archivo compose de producción lee la misma variable y no publica ningún puerto de base de datos.
La primera ejecución
pnpm devEso inicia cuatro componentes: la API en el puerto 3100, Graphile Worker, la aplicación web de Vite en 5173 y el supervisor del sandbox en 7091 de forma predeterminada. Si esos puertos están ocupados, pnpm dev selecciona otro bloque libre e imprime las URL. En los puertos predeterminados, la aplicación está en http://127.0.0.1:5173 y debería aparecer una página de inicio de sesión.
En un VPS no está sentado delante de esa máquina, y no debe publicar 5173 para acceder a ella. Reenvíe los puertos mediante SSH (secure shell) desde su propia máquina.
ssh -L 5173:127.0.0.1:5173 -L 3100:127.0.0.1:3100 you@your-serverPreste atención a la diferencia entre las formas de ejecutar esto. pnpm dev ejecuta Vite en el host, enlazado localmente. El archivo de compose de desarrollo publica el servicio web en 127.0.0.1:5173:5173 y su servicio api en 127.0.0.1:3100:3100, ambos sólo en loopback, por lo que el mismo túnel funciona con él. En el archivo de producción, la aplicación web no publica ningún puerto del host y sólo expone 5173 a los contenedores de sus propias redes, mientras que Caddy publica únicamente los puertos 80 y 443. Por tanto, use el archivo de producción y su reverse proxy para cualquier instancia que deje en ejecución.
¿Qué proveedor de sandbox es seguro en un servidor?
Esta es la única configuración que debe quedar bien. SANDBOX_PROVIDER en .env está configurado como docker de forma predeterminada, y el checkout fijado también admite Railway además de los proveedores enumerados en el documento de autohospedaje.
dockeres el valor predeterminado. Los ordenadores de los bots se ejecutan como contenedores en su máquina, se crean a partir de la imagen producida por el comandopnpm sandbox:buildy se ejecutan bajo un supervisor. De forma predeterminada, los bots de un workspace comparten un Team Computer, y un bot sólo obtiene su propio contenedor en un Private Computer. No se necesita ninguna cuenta de E2B.e2bejecuta los ordenadores de los bots en E2B y necesitaE2B_API_KEY. Env0.3.5, la factory lo acepta en producción cuando se proporciona la clave, sin ninguna restricción deNODE_ENV. El documento de autohospedaje lo considera adecuado para producción pública o multiusuario, porque mantiene los ordenadores de los bots alejados del host que ejecuta la API y la base de datos.daytona,createosyboatson otros proveedores remotos, y cada uno necesita su propia clave:DAYTONA_API_KEY,CREATEOS_SANDBOX_API_KEYoBOAT_API_KEY.railwayejecuta ordenadores en Railway y necesitaRAILWAY_API_TOKENy unRAILWAY_ENVIRONMENT_IDseleccionado explícitamente en la API y el worker. Use un proyecto o entorno de Railway dedicado para los sandboxes.desktopejecuta directamente los comandos del bot en el host de la API y el worker, como indica el documento. Env0.3.5, la API y el worker lo rechazan a menos queNODE_ENVseadevelopmentotest, pero.env.exampleincluyeNODE_ENV=development, por lo que un servidor que ejecutepnpm devtodavía lo acepta. No lo habilite en un servicio público o compartido.fakees un emulador destinado únicamente a la verificación. No es un entorno de ejecución.noneinicia el producto sin ningún host de ordenador.
Tómelo literalmente. En el modo de escritorio no existe ningún límite de aislamiento, por lo que el bot ejecuta comandos de shell como el usuario que ejecuta el proceso de la API, con el directorio personal de ese usuario, sus claves SSH, sus credenciales de cloud y su .env. El texto de una página web que lee el bot se convierte en un comando en su servidor. El modo de escritorio en un servidor es la forma en que un bot termina teniendo sus credenciales. Úselo en una máquina situada frente a usted, o no lo use. Cambiar de proveedor coloca un contenedor alrededor de esa ruta de la página web, pero no la cierra, y darle al bot su propio backend de búsqueda SearXNG cubre la misma superficie de inyección desde el lado de la búsqueda.
docker es un límite real entre los bots y su host, y uno débil entre los propios bots. De forma predeterminada, comparten un único Team Computer, y el documento del runtime del ordenador indica que los bots de un Team comparten el usuario del sistema operativo, el workspace, los perfiles del navegador y el acceso a shell y X11, y que las carpetas por bot organizan el trabajo, pero no son límites de seguridad. Por tanto, cualquier bot de un Team puede leer los archivos de otro bot del mismo Team. Un bot que necesite sus propios límites debe ejecutarse en un Private Computer, que el proveedor docker ejecuta como un contenedor hermano independiente en su propia red. Sin embargo, el supervisor que crea esos contenedores monta /var/run/docker.sock, y el documento de autohospedaje lo indica claramente: el acceso a ese socket equivale a controlar el host de Docker. Por tanto, mantenga privado el supervisor. .env.example trata SANDBOX_SUPERVISOR_TOKEN como una credencial dedicada, distinta de BETTER_AUTH_SECRET, que los sandboxes de Docker necesitan fuera del desarrollo local, y se distribuye con un valor de marcador de posición que cualquiera puede leer en GitHub. Asígnele su propio valor aleatorio. Para obtener la separación más sólida disponible aquí, use e2b o dé a Rakazo una máquina que no contenga nada más. Ese es el mismo razonamiento que sustenta ejecutar agentes de programación en una VM desechable: la forma más barata de sobrevivir a un error de un agente es que su máquina no tenga ningún valor.
¿Dónde se almacenan las claves de API de los modelos?
La facturación opcional de créditos de modelos de Rakazo permanece desactivada a menos que se configuren los dos secretos de Stripe. Usted proporciona la clave. .env.example establece PI_DEFAULT_PROVIDER=openrouter, por lo que OPENROUTER_API_KEY es el lugar habitual, y las claves de los proveedores funcionan mediante la misma configuración.
Mantenga la clave en .env y fuera de cualquier archivo que confirme en el repositorio. Los dos comandos compose del repositorio pasan --env-file .env, por lo que los valores llegan a los contenedores sin escribirse nunca en archivos YAML que git rastrea. También puede dejar OPENROUTER_API_KEY vacío y conectar un modelo en la aplicación después del registro. Esta es otra razón por la que ENCRYPTION_KEY necesita un valor aleatorio real en lugar del marcador de posición incluido.
Establezca un límite de gasto para la clave en el proveedor antes de que un bot pueda usarla. Un bot que entra en un bucle también genera gastos. Rakazo proporciona además MAX_TOOL_CALLS_PER_TURN: establezca un entero positivo para detener de forma flexible un turno que supere su presupuesto de llamadas a herramientas, mientras sigue generando un mensaje final del asistente. Si no está definido, está vacío o es 0, 0 no impone ningún límite. Este valor cuenta las llamadas a herramientas, no el dinero, por lo que no sustituye el límite de gasto del proveedor. Asigne a esta clave un nombre propio para poder revocarla de forma independiente. Si configura esto para un equipo en lugar de hacerlo para usted, la puerta de enlace única de OneCLI delante de los agentes de todos ofrece una solución diferente al mismo problema, porque mantiene las claves de los proveedores en un solo lugar en vez de usar una por persona.
Pasar del modo de desarrollo a una instalación que pueda dejar en ejecución
El repositorio incluye un archivo de Compose para producción que ejecuta Postgres, la API, el worker, la aplicación web y Caddy para los certificados TLS (seguridad de la capa de transporte) que obtiene automáticamente. Caddy es el único servicio que publica puertos. De forma predeterminada, usa E2B para los equipos del bot. La superposición opcional infra/compose/docker-compose.prod.docker.yml ejecuta equipos Docker locales en la misma pila, pero la documentación advierte que el supervisor que añade tiene privilegios equivalentes a root en el host.
sudo --preserve-env=SSH_CONNECTION DEPLOY_USER=deploy bash infra/compose/harden-host.sh
docker compose --env-file .env -f infra/compose/docker-compose.prod.yml \
build --build-arg GIT_SHA=$(git rev-parse HEAD)
docker compose --env-file .env -f infra/compose/docker-compose.prod.yml \
up -d --wait --pull never
curl --fail https://app.example.com/healthCree una cuenta deploy que sólo use claves y confirme que puede iniciar sesión con ella antes de ejecutar el script. harden-host.sh deshabilita las contraseñas SSH y el inicio de sesión de root, limita la tasa de conexiones SSH, añade permisos para SSH, HTTP y HTTPS mediante UFW (firewall sin complicaciones) y conserva las reglas existentes para redes privadas. También activa fail2ban, las actualizaciones de seguridad desatendidas, AppArmor y las reglas de auditoría. Se niega a ejecutarse sin SSH_CONNECTION. Por eso el comando lo pasa mediante sudo. Revierte el cambio del firewall a menos que lo confirme desde una sesión SSH nueva en un plazo de tres minutos. Léalo antes de ejecutarlo, porque cambia la forma de iniciar sesión y recarga SSH. Mantenga abierta la consola de su proveedor hasta que el inicio de sesión SSH nuevo funcione.
El .env de producción necesita más elementos que el de desarrollo. La documentación de instalación independiente enumera estos requisitos mínimos y los secretos.
NODE_ENV=production
RAKAZO_HOST=app.example.com
BETTER_AUTH_URL=https://app.example.com
WEB_ORIGIN=https://app.example.com
API_URL=https://app.example.com
SIGNUPS_ENABLED=true
SIGNUP_ALLOWLIST=you@example.com
SANDBOX_PROVIDER=e2b
AGENT_RUNTIME=pi
WAKEUP_DRIVER=graphile
DATA_DIR=/data
RAKAZO_DEPLOY_DIR=/srv/rakazo
RAKAZO_IMAGE_TAG=local
POSTGRES_PASSWORD=<random, URL-safe>
POSTGRES_APP_PASSWORD=<random, URL-safe>
BETTER_AUTH_SECRET=<random>
ENCRYPTION_KEY=<64 random hex characters>
SCREEN_PROXY_SECRET=<random>
E2B_API_KEY=<your key>
OPENROUTER_API_KEY=<your key>Apunte un registro A al servidor antes de ese primer up. Caddy solicita un certificado para el nombre indicado en RAKAZO_HOST. El nombre debe resolver a este equipo y el puerto 80 para la validación HTTP o el puerto 443 para la validación TLS-ALPN debe ser accesible desde Internet. Ambos desafíos están habilitados de forma predeterminada. Por tanto, cerrar sólo el puerto 80 no impide emitir el certificado a través del puerto 443.
Mantenga SIGNUP_ALLOWLIST configurado con su propia dirección desde el principio. .env.example incluye SIGNUPS_ENABLED=true, y ambas opciones se leen del entorno cada vez que se inicia la API. Por tanto, una instancia con un nombre público, los registros habilitados y ninguna lista de permitidos acepta registros de cualquier persona que la encuentre. Una lista de permitidos no vacía se aplica en cada inicio y sustituye la lista almacenada. El registro con lista de permitidos requiere verificar el buzón de correo, incluido el de la primera cuenta. Configure el envío de correo antes de registrarse. Sin correo electrónico, la documentación indica que se debe iniciar con SIGNUPS_ENABLED=false y crear la cuenta mediante el comando de bootstrap del servidor que proporciona. Esto crea una cuenta verificada normal sin privilegios en el servidor. Configure primero la lista de permitidos. Puede relajarla después si lo necesita. Si ya ejecuta varios servicios en el mismo equipo y prefiere mantener una sola lista de personas en lugar de una lista de permitidos por aplicación, colocar una instancia de Authentik delante de ellos traslada esa decisión al proxy. Authentik se sitúa delante de las cuentas de Better Auth propias de Rakazo, pero no las sustituye.
Considere docs/self-host.md del repositorio como la referencia autorizada para la configuración de producción, porque cambia junto con el código y esta guía no se actualiza con él. Como Compose realiza el trabajo, se aplican las reglas habituales. Los conceptos básicos de Docker Compose para un VPS explican por qué --env-file y los volúmenes con nombre son más importantes cuando una pila se deja sin cambios durante meses.
Copias de seguridad
En esta configuración, Postgres y el directorio data/ contienen los datos de la instancia. La recuperación también necesita ENCRYPTION_KEY y cualquier clave maestra de contenido configurada, por lo que debe conservar copias fuera del servidor.
./scripts/backup.sh
./scripts/restore.sh backups/BACKUP_TIMESTAMPbackup.sh vuelca Postgres y archiva data/. restore.sh funciona en la pila de Compose de desarrollo, en una base de datos vacía y con los servicios de la aplicación detenidos. No lee los archivos de copia de seguridad de producción. En una máquina de la que dependa, instale infra/compose/backup-prod.sh como /usr/local/sbin/rakazo-backup junto con el temporizador que proporciona el repositorio. Escribe un volcado verificado y un archivo de datos de la aplicación en /var/backups/rakazo. De forma predeterminada, conserva hasta tres instantáneas verificadas, un límite definido por RAKAZO_BACKUP_KEEP, dentro de un máximo de 50 GiB definido por RAKAZO_BACKUP_MAX_GB. Antes de cada ejecución, elimina las instantáneas parciales y el historial sobrante, por lo que la rotación es automática. También puede cifrar cada copia de seguridad con age para los destinatarios públicos que indique en /etc/rakazo/backup.env, de modo que el servidor escriba copias de seguridad que no pueda leer. Genere ese par de claves en una máquina que controle y conserve la clave privada fuera del servidor. Sin destinatarios, la copia de seguridad permanece en texto plano y se registra una advertencia. Sin embargo, después de la primera copia de seguridad cifrada, una ejecución sin destinatarios falla, a menos que permita explícitamente el texto plano con RAKAZO_BACKUP_ALLOW_PLAINTEXT=1. Una copia de seguridad almacenada en el mismo disco que la base de datos no es una copia de seguridad. Cópiela fuera del servidor. Después, restáurela una vez en un servidor de reserva, antes de necesitarla.
Por qué falla y qué verá
pnpm db:migrate no puede acceder a la base de datos. La migración informa de que no puede acceder al servidor de base de datos en 127.0.0.1:5433. El contenedor de Postgres puede no estar iniciado, puede estar iniciado pero todavía no listo, o puede haberse iniciado sin la superposición docker-compose.postgres-host.yml, que es la que publica 5433 en el host. Ejecute docker compose --env-file .env -f infra/compose/docker-compose.yml ps y busque el servicio postgres con estado healthy, porque el archivo de Compose le asigna una comprobación de estado que se ejecuta cada tres segundos. Si el contenedor se reinicia continuamente, lea sus registros: la pila de Compose fijada no se inicia con un volumen antiguo de Postgres 16 hasta que se migra a Postgres 18. docker compose ... down -v lo borra, junto con los datos.
El puerto ya está ocupado. Iniciar Postgres falla con bind: address already in use cuando otro proceso usa 5433, normalmente una pila de Rakazo anterior que olvidó detener. sudo ss -lntp | grep 5433 muestra el proceso. La superposición lee el puerto del host desde POSTGRES_HOST_PORT, por lo que puede cambiarlo, siempre que también cambie DATABASE_URL y DATABASE_MIGRATION_URL.
Un bot nunca obtiene un equipo. Con SANDBOX_PROVIDER=docker y sin la imagen rakazo/computer:local, no hay nada que iniciar. docker image ls rakazo/computer lo confirma en una línea y pnpm sandbox:build lo corrige. Si el supervisor no puede acceder al socket de Docker, tampoco puede crear contenedores, y el mensaje muestra la ruta: permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock.
Un comando largo termina a mitad de la ejecución. .env.example establece SANDBOX_COMMAND_TIMEOUT_MS=300000, por lo que un solo comando dentro del equipo de un bot se interrumpe después de cinco minutos. Auméntelo para compilaciones lentas en lugar de asumir que el sandbox se bloqueó.
pnpm install falla de formas confusas. Compruebe node -v antes que nada. El workspace declara ^22.22.2 || ^24.0.0 || >=26.0.0, por lo que 23.x, 25.x y cualquier versión 22.x anterior a 22.22.2 están fuera de ese rango. El .npmrc fijado establece engine-strict=true, por lo que pnpm install rechaza una versión de Node no compatible con un error de motor o de versión antes de que se ejecute el código de dependencias de la aplicación.
El inicio de sesión funciona localmente, pero no a través del dominio. BETTER_AUTH_URL, WEB_ORIGIN y API_URL deben contener el mismo origen público que la barra de direcciones, incluido el esquema. Un http://127.0.0.1:5173 obsoleto en uno de ellos suele causar que la sesión no se mantenga.
Actualizar una copia de trabajo fijada
El procedimiento de actualización de la documentación de self-host para una pila de Compose de producción creada a partir de la copia de trabajo es breve: descargue el código fuente nuevo y, después, vuelva a crear y reinicie la API, el worker y la aplicación web. Las migraciones se ejecutan cuando se inicia la API, porque su comando de inicio las aplica antes de atender peticiones.
sudo /usr/local/sbin/rakazo-backup
git fetch --all --tags
git checkout NEW_COMMIT_SHA
export GIT_SHA=$(git rev-parse HEAD)
docker compose --env-file .env -f infra/compose/docker-compose.prod.yml \
up -d --wait --pull never --build api worker webHaga una copia de seguridad primero. Las migraciones avanzan y una beta no ofrece una vía de reversión fiable. Si su copia de trabajo es anterior al 30 August 2026, lo que incluye el commit v0.1.0-beta, lea la nota de la documentación sobre la migración 20260830200000_space_scope_names_and_user_credentials antes de actualizar. Es un cambio coordinado: detenga primero la API y el worker antiguos y ejecute la comprobación del límite de privacidad de Space que indica la documentación. Si actualiza desde una copia de trabajo anterior al inicio de sesión separado de la aplicación, establezca POSTGRES_APP_PASSWORD en .env antes de volver a crear los servicios; el archivo de Compose de producción no se inicia sin ese valor. Los archivos de Compose de la copia de trabajo y de producción también ejecutan Postgres 18: una instalación existente de Postgres 16 necesita el procedimiento infra/compose/upgrade-postgres.sh de la documentación antes de poder iniciarse con la nueva disposición. Lea los commits entre el SHA fijado y el nuevo antes de aplicarlos, porque un proyecto tan reciente cambia los nombres de las variables de entorno sin anunciarlo, y una variable ausente se manifiesta como un servicio que se inicia y después termina. Si todavía está decidiendo si Rakazo es adecuado para ejecutar en absoluto, el resumen de agentes de IA autoalojados explica qué otras opciones existen en esta categoría y cuánto cuesta mantener cada una.
FAQ
¿Puedo ejecutar Rakazo en un VPS de 1 GB?
No. Postgres, la API, el worker, el supervisor del sandbox y la aplicación web se ejecutan al mismo tiempo. Con SANDBOX_PROVIDER=docker, el ordenador de los bots añade un contenedor que contiene un escritorio gráfico, con una pantalla X y un proceso de Chrome independientes para cada bot activo. Todo queda dentro de un límite predeterminado de 2 GB de memoria y dos CPU. La documentación de autoalojamiento en v0.3.5 no indica el tamaño del host. Considere 4 GB como el mínimo para el plano de control y use más memoria cuando los escritorios se ejecuten en su máquina.
¿Es seguro el proveedor del sandbox de escritorio en un servidor?
No. La documentación de autoalojamiento indica que desktop ejecuta comandos directamente en el host de la API y del worker. Por tanto, el bot actúa como el usuario que ejecuta ese proceso y puede acceder a los archivos y credenciales de ese usuario. En v0.3.5, la API y el worker lo rechazan fuera de los modos de desarrollo y prueba, pero un servidor que ejecuta pnpm dev está en modo de desarrollo y lo acepta. No lo use en un servidor público o compartido. Use docker para dar a un bot un Private Computer cuando no deba compartir archivos con los demás bots del workspace, o e2b cuando inicie sesión más de una persona.
¿Qué versión de Rakazo debo instalar?
A fecha de 9 de noviembre de 2026, la versión más reciente es v0.8.0, publicada el 4 de noviembre de 2026 y marcada como Latest. Para seguir esta guía, cambie al commit fijado v0.3.5, f31e3c0699f086d663637c4107858c238a086fb3, en lugar de seguir main o la versión preliminar de agosto v0.1.0-beta. Una rama cambia con el tiempo y una etiqueta puede reasignarse, por lo que ninguna identifica un árbol al que pueda volver. Registre el commit, porque sólo puede volver atrás si sabe cuál funcionaba.
¿Dónde debo poner mi clave de API de OpenRouter?
En .env como OPENROUTER_API_KEY, y nunca en un archivo de compose que vaya a confirmar. Los dos comandos de compose del repositorio pasan --env-file .env, por lo que el valor llega a los contenedores sin escribirse en YAML bajo control de versiones. También puede dejarlo vacío y conectar un modelo en la aplicación después de registrarse. Establezca un límite de gasto para la clave en el proveedor, porque un bot atrapado en un bucle seguirá llamando al modelo hasta que algo lo detenga.
¿Necesito un nombre de dominio y TLS?
Para cualquier uso posterior a una primera prueba, sí. El archivo de compose de producción ejecuta Caddy y obtiene los certificados automáticamente. Configure RAKAZO_HOST con el nombre de host público, y BETTER_AUTH_URL, WEB_ORIGIN y API_URL con el mismo origen HTTPS público. Para una primera prueba puede omitir el dominio: ejecute pnpm dev y reenvíe el puerto 5173 mediante SSH en lugar de publicarlo.