Argunis/On-premise/Instalar

Instala Argunis en tu servidor

Un solo comando instala Docker, Portainer y Argunis, y al final te muestra las direcciones y contraseñas.

Requisitos del servidor

Un servidor (físico o máquina virtual) dedicado a Argunis. El instalador revisa todo esto antes de empezar y te dice qué falta.

  • Sistema: Ubuntu 22.04, Ubuntu 24.04 o Debian 12, de 64 bits: x86_64 (Intel o AMD) o ARM (aarch64, ARMv8.2 o más nuevo: AWS Graviton, Ampere, Raspberry Pi 5 o una VM en Mac con chip M). El comando es el mismo; el servidor descarga solo las imágenes de su arquitectura.
  • CPU: 4 como mínimo.
  • Memoria: 12 GB de RAM como mínimo. Con 12 GB la IA local usa un modelo de 4B y con 16 GB o más uno de 7B, que responde mejor. No necesitas GPU.
  • Disco: 100 GB libres en SSD.
  • Internet: salida HTTPS (puerto 443) hacia api.argunis.com, ws.argunis.com, argunis.com, ghcr.io y registry-1.docker.io (programas), y registry.ollama.ai (modelo de IA, la primera vez).
  • Puertos libres: 80 y 443 (Argunis), 8443 (agentes) y 9443 (Portainer). Si el 443 está ocupado, el instalador elige otro libre y al final te muestra la dirección exacta.
  • Acceso: un usuario con permiso de administrador (sudo) y poder conectarte por SSH o por la consola de la máquina virtual.

Instalación paso a paso

No necesitas saber de Docker. Tarda entre 15 y 40 minutos según tu conexión.

  1. Pide tu clave de prueba

    Completa el formulario y confirma tu correo. Verás tu clave JTRL-… una sola vez y también te llega por correo: guárdala, la usarás en el paso 4.

  2. Conéctate al servidor

    Abre una terminal (Windows: PowerShell; Mac y Linux: Terminal) y escribe este comando cambiando usuario por tu usuario del servidor y 192.168.1.50 por su IP.

    La primera vez te preguntará si confías en el servidor: escribe yes y Enter.

  3. Pega el comando del instalador

    Pégalo en la terminal del servidor y presiona Enter. Te pedirá tu contraseña de administrador.

    curl -fsSL https://argunis.com/instalar.sh | sudo bash
    curl -fsSL https://argunis.com/instalar.sh | sudo bash -s -- --probar

    Al terminar verás la dirección de Argunis y el usuario y la contraseña de Portainer. Anota la contraseña: se muestra una sola vez (queda en /opt/argunis/acceso.txt, solo para administradores).

  4. Abre Argunis y completa el asistente

    En tu navegador abre https:// y la IP del servidor, por ejemplo https://192.168.1.50. El navegador mostrará un aviso de conexión no privada porque Argunis usa un certificado propio de tu servidor:

    • Chrome o Edge: Configuración avanzada → Continuar al sitio.
    • Firefox: Avanzado… → Aceptar el riesgo y continuar.
    • Safari: Mostrar detalles → visitar este sitio web.

    Pega tu clave JTRL-… y completa los datos de tu empresa, el correo (SMTP) y tu usuario administrador con su segundo factor (MFA).

  5. Administra con Portainer

    Abre https://192.168.1.50:9443 y entra con el usuario admin y la contraseña que mostró el instalador. En Stacks → argunis-onpremise ves cada servicio, sus registros y puedes reiniciarlos.

Si algo falla

Reintenta el instalador

Vuelve a pegar el mismo comando: retoma donde quedó y repara lo que falte, sin perder datos ni cambiar claves.

curl -fsSL https://argunis.com/instalar.sh | sudo bash

Mira el estado

En Portainer o en la terminal. Postgres y ClickHouse quedan «esperando» hasta que actives la clave: es normal.

sudo docker ps --format "table {{.Names}}\t{{.Status}}"

Recupera los datos de acceso

Direcciones, usuario y contraseña de Portainer, y el registro de la instalación:

sudo cat /opt/argunis/acceso.txt
sudo tail -n 50 /opt/argunis/instalador.log

Actualiza a una versión nueva

Cuando te avisemos de una versión nueva, conserva tus datos y claves:

curl -fsSL https://argunis.com/instalar.sh | sudo bash -s -- --actualizar
  • «No llega a …»: el firewall o el proxy bloquean la salida a ese nombre por el puerto 443. Pide que la abran y reintenta.
  • «No hay suficiente memoria, disco o CPU»: amplía la máquina virtual y reintenta.
  • Certificado propio: copia tu certificado y su llave como /opt/argunis/tls/tls.crt y tls.key (dueño 101) y reinicia el servicio web en Portainer.
  • ¿Sigues con problemas? Escríbenos a [email protected] con el mensaje de error y el archivo /opt/argunis/instalador.log.

Descargas de la versión vigente

Cada archivo con su SHA-256 para que puedas verificarlo. Las imágenes van fijadas por digest en el docker-compose.yml. Versiones

Cargando la versión vigente…

Para revisar el instalador antes de correrlo: descárgalo, compara su SHA-256 con el de la tabla y ejecútalo.

curl -fsSLO https://argunis.com/instalar.sh && sha256sum instalar.sh
sudo bash instalar.sh

Instalar a mano en tu propio Portainer

Para equipos que ya administran Docker y Portainer. Si no es tu caso, usa el instalador de arriba: hace todo esto solo.

  1. Prepara el servidor

    Módulos del disco cifrado, carpetas de /opt/argunis, montaje compartido y perfil seccomp del navegador de pruebas:

    sudo modprobe loop dm_crypt && printf "loop\ndm_crypt\n" | sudo tee /etc/modules-load.d/argunis.conf
    sudo mkdir -p /opt/argunis/secure /opt/argunis/vault-state /opt/argunis/vault-data /opt/argunis/seccomp /opt/argunis/tls
    sudo install -d -o 1000 -g 1000 /opt/argunis/control && sudo chmod 700 /opt/argunis/vault-state /opt/argunis/vault-data
    echo "/opt/argunis/secure /opt/argunis/secure none bind,rshared 0 0" | sudo tee -a /etc/fstab && sudo mount /opt/argunis/secure
    sudo curl -fsSL -o /opt/argunis/seccomp/chromium.json https://argunis.com/descargas/VERSION/chromium.json
  2. Crea el certificado HTTPS

    Autofirmado (o copia el tuyo como tls.crt y tls.key):

    IP=192.168.1.50   # la IP de tu servidor
    sudo openssl req -x509 -newkey rsa:2048 -nodes -days 825 -subj "/CN=$IP" -addext "subjectAltName=IP:$IP" \
      -keyout /opt/argunis/tls/tls.key -out /opt/argunis/tls/tls.crt && sudo chown 101:101 /opt/argunis/tls/tls.key /opt/argunis/tls/tls.crt
  3. Genera el archivo de variables (.env)

    El mismo instalador genera todas las claves sin instalar nada. Guarda una copia fuera del servidor: sin esas claves no se pueden abrir los datos.

    curl -fsSL https://argunis.com/instalar.sh | bash -s -- --solo-generar-env argunis.env
  4. Crea el stack en Portainer

    Stacks → Add stack, nombre argunis-onpremise: pega el docker-compose.yml de la versión y, en Environment variables → Advanced mode, el contenido de argunis.env.

Hablemos

Cuéntanos qué necesitas y te respondemos a la brevedad.

Agenda una demo

Elige el día y la hora. La reunión es por Google Meet y dura 30 minutos.

Día
Hora · Hora de Chile (Santiago)

Buscando horas libres…