Guía de despliegue

Instalar Windmill en un VPS: automatización self-hosted

Desplegar en un VPS Cloud →

Tutorial

Instalar Windmill en un VPS: automatización self-hosted

Automatización3 min de lectura5 pasos

Windmill es una plataforma open source que convierte código (Python, TypeScript, Go, Bash, SQL) en workflows, API e interfaces internas. Pensada para desarrolladores, combina la flexibilidad del código con la rapidez del no-code. Autoalojada en un VPS, se convierte en su motor de automatización y en su app builder interno, sin depender de un SaaS.

Contenido· Por qué autoalojar Windmill en un VPS1/4
  1. 01Por qué autoalojar Windmill en un VPS
  2. 02Ventajas concretas del autoalojamiento
  3. 03Requisitos técnicos
  4. 04Desplegar Windmill con Docker Compose

Por qué autoalojar Windmill en un VPS

Windmill se ejecuta de forma continua en su servidor y expone cada uno de sus scripts como una API REST firmada, una tarea programada o una interfaz autogenerada. A diferencia de una función serverless, no hay arranque en frío ni límite de ejecución impuesto por un tercero. Sus scripts en Python, TypeScript o Bash acceden directamente a las bases de datos y a los servicios internos de su VPS, sin atravesar ninguna pasarela cloud. El motor está escrito en Rust: consume menos de 100 MB de RAM en reposo y arranca en pocos segundos incluso en el VPS Cloud más pequeño.

Ventajas concretas del autoalojamiento

  • Ningún coste por ejecución: miles de jobs al día sin factura de nube.
  • Acceso directo a las bases de datos y a los servicios internos del VPS, sin túnel.
  • Secretos y claves de API almacenados en Windmill, que nunca salen de su servidor.
  • Formularios de entrada y endpoints REST generados automáticamente para cada script.
  • Workers adicionales que se añaden en caliente para absorber los picos de carga.
  • Versionado Git integrado — cada modificación de un script queda trazada.

Requisitos técnicos

Windmill necesita como mínimo 2 vCPU y 4 GB de RAM para ejecutar el servidor, un worker por defecto y un worker nativo contra PostgreSQL 16. Calcule 10 GB de disco para los logs, la caché de los workers y los volúmenes de la base de datos. Basta con Ubuntu 22.04 o 24.04 con Docker instalado. No se requiere ningún GPU. Si prevé ejecutar workers Python pesados (ML, pandas sobre grandes conjuntos de datos), opte por 4 vCPU y 8 GB de RAM.

Desplegar Windmill con Docker Compose

  1. Clonar el repositorio oficial

    Conéctese por SSH a su VPS y descargue el docker-compose.yml oficial:

    git clone https://github.com/windmill-labs/windmill.git && cd windmill

    Para producción, fije una versión estable (consulte las releases de GitHub). La rama main es estable, pero puede incluir correcciones aún en pruebas.

  2. Generar los secretos de entorno

    Copie .env.example en .env y rellene las variables:

    cp .env.example .env

    Para DATABASE_URL, puede utilizar el PostgreSQL incluido en la stack (--profiles pg up) o apuntar a una instancia existente. Rellene BASE_URL con https://votre-domaine.com — Windmill lo utiliza para firmar los webhooks y construir las URL de retorno de los flows.

  3. Arrancar la stack

    Inicie el servidor, el worker por defecto y el worker nativo:

    docker compose --profile pg up -d

    Compruebe que los cuatro contenedores están Up con docker compose ps. El servidor escucha en el puerto 8000 del bucle local.

  4. Configurar el reverse proxy nginx

    Windmill expone el puerto 8000 en 127.0.0.1. Configure nginx para hacer de proxy y terminar el TLS:

    location / {
        proxy_pass http://127.0.0.1:8000;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
    }

    Las cabeceras Upgrade y Connection son necesarias para los WebSockets que utiliza el editor en tiempo real.

  5. Conectarse y proteger la instancia

    Abra https://votre-domaine.com, inicie sesión con [email protected] / changeme y vaya a Ajustes → Usuarios para definir una contraseña robusta y, si lo desea, cambiar la dirección de correo del administrador. El acceso directo al editor sin autenticación es el fallo más habitual en las instancias de Windmill expuestas públicamente.

Instalarlo con un solo clic desde el Marketplace de ServOrbit. Si prefiere evitar la configuración manual, el Marketplace de ServOrbit aprovisiona Windmill automáticamente — servidor, dos workers, PostgreSQL 16, reverse proxy nginx y certificado Let's Encrypt — en unos minutos. La sección «Primer acceso» de su área de cliente indica la URL y las credenciales generadas. Vaya a la [ficha de Windmill](/marketplace/automatisation/windmill) para empezar.

Despliegue Windmill con un clic en su VPS ServOrbit

El Marketplace de ServOrbit aprovisiona automáticamente Windmill con PostgreSQL 16, dos workers y un reverse proxy — sus scripts pasan a producción en unos minutos, sin una sola línea de configuración.

¿Necesita ayuda?

Consulte nuestro centro de ayuda y nuestra FAQ, o contacte con nuestro equipo: llamada, WhatsApp o correo electrónico. Soporte en francés, inglés y árabe.

Escribir por WhatsAppse abre en una pestaña nueva