Administradores

Ejecuta tu propio servidor de Welley

Nuestra herramienta de línea de comandos instala todo lo que Welley necesita en una sola máquina Linux. Puede ser un servidor en la nube o tu propio hardware.

Leer: Inicio rápido: despliegue mínimo de Welley Leer: Welley CLI Instala Docker Engine

Planeamos publicar Welley como código abierto en el futuro. Todavía no se ha anunciado una fecha de lanzamiento ni una licencia.

Prepara el host, el DNS y el correo

Estos son los requisitos iniciales de la guía de inicio rápido. La capacidad que necesitas depende de tus usuarios y de tu carga de trabajo.

Host Linux

Ubuntu 24.04 LTS u otra distribución actual similar.
Empieza con 2 vCPU, 4 GB de RAM y 60 GB de disco.
Usa una dirección IPv4 pública fija y un usuario que no sea root con sudo.

Red

Permite TCP 80 y 443 de entrada desde internet. Permite TCP 22 desde tu propia red.
Deja libre el puerto 80 para el desafío del certificado y la renovación semanal del certificado.

DNS del sitio

Apunta tu dominio y storage.<domain> a la dirección IP del host.
Crea ambos registros antes de instalar. La CLI los comprueba y se detiene si no resuelven al host.

SMTP y correo del administrador

Ten a mano el host SMTP, el usuario, la contraseña y la dirección del remitente. El valor predeterminado es STARTTLS en el puerto 587.
También necesitarás un correo de administrador para el primer inicio de sesión y para recuperar la contraseña.

DNS del correo

Configura SPF, DMARC y el DKIM que genera tu proveedor, para el dominio de la dirección del remitente.
Usa el valor SPF exacto de tu proveedor. Combínalo con tu registro SPF existente en lugar de añadir un segundo registro.
La CLI te avisa si falta SPF o DMARC. No puede comprobar el selector DKIM de tu proveedor.

Instala Docker Engine y Compose

Sigue las instrucciones oficiales de Docker para tu distribución de Linux. Después, da acceso a Docker a tu usuario de despliegue.

Instalación de Docker Engine

Añade al usuario al grupo de Docker

Reemplaza <user> por tu usuario de despliegue que no sea root. Después de ejecutar este comando, cierra sesión y vuelve a iniciarla.

sudo usermod -aG docker <user>

Comprueba Docker y Compose

Ambos comandos deben funcionar para ese usuario.

docker ps
docker compose version

Descarga la CLI

Elige el binario para la máquina en la que ejecutarás la CLI. El host de despliegue en sí tiene que ejecutar Linux.

Linux, x86-64

curl -fL "https://appstore.allroads.social/v1/social.wellesley.wlycli/latest?channel=stable&platform=linux/amd64" -o wlycli
chmod +x wlycli
./wlycli -v

Linux, ARM64

curl -fL "https://appstore.allroads.social/v1/social.wellesley.wlycli/latest?channel=stable&platform=linux/arm64" -o wlycli
chmod +x wlycli
./wlycli -v

macOS, Apple silicon

curl -fL "https://appstore.allroads.social/v1/social.wellesley.wlycli/latest?channel=stable&platform=darwin/arm64" -o wlycli
chmod +x wlycli
./wlycli -v

macOS, Intel

curl -fL "https://appstore.allroads.social/v1/social.wellesley.wlycli/latest?channel=stable&platform=darwin/amd64" -o wlycli
chmod +x wlycli
./wlycli -v

Estos comandos descargan del canal estable y muestran la versión de la CLI.
La versión cambia con cada lanzamiento nuevo. Usa la documentación más reciente de la CLI cuando instales.

Crea el despliegue

Ejecuta este comando en el host Linux que preparaste. Reemplaza el dominio, el correo y los valores SMTP de ejemplo por los tuyos.

./wlycli deploy create \
-d example.com \
-e admin@example.com \
--smtp-host smtp.example.com \
--smtp-user "$MAIL_USER" \
--smtp-password "$MAIL_PASSWORD" \
--smtp-from noreply@example.com

Ajuste	Valor predeterminado
Directorio de instalación	~/.welley/<project>. El dominio de ejemplo produce el nombre de proyecto example_com.
Base de datos	PostgreSQL incluido, con los datos dentro del directorio de instalación.
Componentes	Plataforma Welley, pipeline de RAG, Nginx, Redis y PostgreSQL, con contenedores de mantenimiento.
Certificados	Let’s Encrypt mediante Certbot, con renovación semanal.
Multimedia	Subidas y archivos estáticos en https://storage.<domain>.
Actualizaciones	Canal estable, con revisión diaria. El proceso de actualización evita las interrupciones del servicio siempre que es posible.
Servicios opcionales	La configuración mínima no añade una base de datos administrada, CDN, telemetría ni integración con Slack.

Antes de ejecutarlo, define MAIL_USER y MAIL_PASSWORD con tus credenciales SMTP.
La guía de inicio rápido requiere estas seis opciones.
El comando comprueba el DNS, escribe los archivos del despliegue, obtiene un certificado con Certbot e inicia los contenedores.
El comando deploy es un alias de deployment.

La contraseña de administrador generada está en el registro de la plataforma. Mantén esa salida en privado.

Encuentra la contraseña inicial

Este nombre de contenedor es para example.com. Para tu propio dominio, cambia el nombre del proyecto.

docker logs example_com-platform-blue-1 | grep "Auto-init complete"

Inicia sesión

Abre tu dominio e inicia sesión con el correo de administrador que indicaste con -e. Cambia de inmediato la contraseña generada.

Comprueba los contenedores

Según la guía de inicio rápido, deberías ver nginx, platform-blue, rag-pipeline-blue, postgres, redis, autoheal y snoopy.

docker ps

Usa la CLI para administrar

La CLI también tiene comandos para la API de la plataforma. Tu cuenta sigue necesitando los permisos de cada operación.

Antes de ejecutar una operación, revisa sus opciones actuales en la ayuda del comando.
El comando login recibe la URL base de la API, el correo y la contraseña. Guarda el token de sesión que recibe.
Por ahora, el comando de inicio de sesión muestra su token de sesión en el registro cuando termina correctamente. Mantén esa salida en privado.

Grupos de comandos: accounts, posts, apps, emojis, feeds, reports, rules, settings.

Mostrar los comandos disponibles

./wlycli --help

Mostrar los comandos de despliegue

./wlycli deployment --help

Mostrar las opciones de inicio de sesión

./wlycli login --help

Mostrar las opciones de configuración

./wlycli settings --help

Actualizaciones y recuperación

De forma predeterminada, un despliegue busca actualizaciones estables todos los días. El administrador del servidor puede gestionar las versiones en la interfaz de administración.

Si los archivos de tu despliegue siguen siendo válidos pero algunos contenedores fallan, la guía de inicio rápido indica que ejecutes restart, que vuelve a crear los contenedores.
Create no se ejecutará de nuevo mientras el directorio del proyecto o sus contenedores sigan existiendo.
La opción de eliminación forzada borra los archivos del despliegue y la base de datos incluida. No es un paso de recuperación y no conserva tus datos.
La skill deploy-server todavía usa el nombre deployment update. La CLI actual tiene deployment auto-update en su lugar. Revisa la ayuda actual de la CLI antes de hacer mantenimiento a mano.

Volver a crear los contenedores desde el despliegue existente

./wlycli deploy restart -d example.com

Vuelve a crear los contenedores a partir de tu configuración guardada. No borra los datos del despliegue.

Desplegar con un asistente de IA

Si tu asistente de IA admite paquetes SKILL.md, descarga nuestra skill oficial deploy-server. Te guía en un despliegue en DigitalOcean.

Por ahora, la skill solo cubre DigitalOcean. El inicio rápido de la CLI también funciona con otros proveedores de nube y con tu propio host Linux.

Cómo usarlo

Extrae el paquete y carga el directorio deploy-server de la forma en que tu asistente instala skills.
Pide al asistente que use $deploy-server.
La skill te pide el dominio, el acceso al DNS, la configuración de SSH, los datos de SMTP y el correo del administrador.
Puede configurar una VM en DigitalOcean y, si quieres, una base de datos PostgreSQL administrada. Confirma contigo los datos del despliegue y el precio de la base de datos administrada.

Antes de descargar

El paquete es una copia sin cambios de la skill original.
Sus ejemplos de descarga y actualización están desactualizados. Obtén la URL de descarga estable actual en el inicio rápido de este sitio web. Revisa la ayuda de la CLI antes del mantenimiento.
La skill no incluye credenciales de la nube ni un servidor en funcionamiento, y no podemos garantizar que funcione con todos los asistentes.

El paquete tiene SKILL.md, agents/openai.yaml y references/digitalocean.md. Ambas descargas tienen los mismos archivos.

Descargar deploy-server.zip (10,7 KB)Descargar deploy-server.skill (10,7 KB)

Documentos de referencia

La documentación completa de la CLI y los archivos de la skill de despliegue. Puedes leerlos aquí sin una cuenta.