Argunis/On-premise/Instalar

Instale o Argunis no seu servidor

Um único comando instala o Docker, o Portainer e o Argunis e, no final, mostra os endereços e senhas.

Requisitos do servidor

Um servidor (físico ou máquina virtual) dedicado ao Argunis. O instalador verifica tudo isso antes de começar e diz o que falta.

  • Sistema: Ubuntu 22.04, Ubuntu 24.04 ou Debian 12, de 64 bits: x86_64 (Intel ou AMD) ou ARM (aarch64, ARMv8.2 ou mais novo: AWS Graviton, Ampere, Raspberry Pi 5 ou uma VM em Mac com chip M). O comando é o mesmo; o servidor baixa apenas as imagens da sua arquitetura.
  • CPU: no mínimo 4.
  • Memória: no mínimo 12 GB de RAM. Com 12 GB a IA local usa um modelo de 4B e com 16 GB ou mais um de 7B, que responde melhor. Não precisa de GPU.
  • Disco: 100 GB livres em SSD.
  • Internet: saída HTTPS (porta 443) para api.argunis.com, ws.argunis.com, argunis.com, ghcr.io e registry-1.docker.io (programas), e registry.ollama.ai (modelo de IA, na primeira vez).
  • Portas livres: 80 e 443 (Argunis), 8443 (agentes) e 9443 (Portainer). Se a 443 estiver ocupada, o instalador escolhe outra livre e mostra o endereço exato no final.
  • Acesso: um usuário com permissão de administrador (sudo) e poder se conectar por SSH ou pelo console da máquina virtual.

Instalação passo a passo

Você não precisa saber Docker. Leva de 15 a 40 minutos, conforme sua conexão.

  1. Peça sua chave de teste

    Preencha o formulário e confirme seu e-mail. Você verá sua chave JTRL-… uma única vez e ela também chega por e-mail: guarde-a, você a usará no passo 4.

  2. Conecte-se ao servidor

    Abra um terminal (Windows: PowerShell; Mac e Linux: Terminal) e digite este comando trocando usuario pelo seu usuário do servidor e 192.168.1.50 pelo IP dele.

    Na primeira vez ele pergunta se você confia no servidor: digite yes e Enter.

  3. Cole o comando do instalador

    Cole-o no terminal do servidor e pressione Enter. Ele pedirá sua senha de administrador.

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

    No final você verá o endereço do Argunis e o usuário e a senha do Portainer. Anote a senha: ela aparece uma única vez (fica em /opt/argunis/acceso.txt, só para administradores).

  4. Abra o Argunis e complete o assistente

    No navegador abra https:// e o IP do servidor, por exemplo https://192.168.1.50. O navegador mostrará um aviso de conexão não privada porque o Argunis usa um certificado próprio do seu servidor:

    • Chrome ou Edge: Avançado → Continuar para o site.
    • Firefox: Avançado… → Aceitar o risco e continuar.
    • Safari: Mostrar detalhes → visitar este site.

    Cole sua chave JTRL-… e preencha os dados da sua empresa, o e-mail (SMTP) e seu usuário administrador com o segundo fator (MFA).

  5. Administre com o Portainer

    Abra https://192.168.1.50:9443 e entre com o usuário admin e a senha que o instalador mostrou. Em Stacks → argunis-onpremise você vê cada serviço, seus registros e pode reiniciá-los.

Se algo falhar

Rode o instalador de novo

Cole o mesmo comando: ele retoma de onde parou e repara o que faltar, sem perder dados nem trocar chaves.

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

Veja o estado

No Portainer ou no terminal. Postgres e ClickHouse ficam «aguardando» até você ativar a chave: é normal.

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

Recupere os dados de acesso

Endereços, usuário e senha do Portainer e o registro da instalação:

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

Atualize para uma versão nova

Quando avisarmos de uma versão nova, mantenha seus dados e chaves:

curl -fsSL https://argunis.com/instalar.sh | sudo bash -s -- --actualizar
  • «Não chega a …»: o firewall ou o proxy bloqueiam a saída para esse nome pela porta 443. Peça a liberação e tente novamente.
  • «Memória, disco ou CPU insuficientes»: amplie a máquina virtual e tente novamente.
  • Certificado próprio: copie seu certificado e a chave como /opt/argunis/tls/tls.crt e tls.key (dono 101) e reinicie o serviço web no Portainer.
  • Ainda com problemas? Escreva para [email protected] com a mensagem de erro e o arquivo /opt/argunis/instalador.log.

Downloads da versão vigente

Cada arquivo com seu SHA-256 para você verificar. As imagens são fixadas por digest no docker-compose.yml. Versões

Carregando a versão vigente…

Para revisar o instalador antes de rodá-lo: baixe-o, compare o SHA-256 com o da tabela e execute-o.

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

Instalar manualmente no seu próprio Portainer

Para equipes que já administram Docker e Portainer. Se não for o seu caso, use o instalador acima: ele faz tudo isso sozinho.

  1. Prepare o servidor

    Módulos do disco criptografado, pastas de /opt/argunis, montagem compartilhada e perfil seccomp do navegador de testes:

    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. Crie o certificado HTTPS

    Autoassinado (ou copie o seu como tls.crt e 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. Gere o arquivo de variáveis (.env)

    O próprio instalador gera todas as chaves sem instalar nada. Guarde uma cópia fora do servidor: sem essas chaves os dados não podem ser abertos.

    curl -fsSL https://argunis.com/instalar.sh | bash -s -- --solo-generar-env argunis.env
  4. Crie o stack no Portainer

    Stacks → Add stack, nome argunis-onpremise: cole o docker-compose.yml da versão e, em Environment variables → Advanced mode, o conteúdo de argunis.env.

Vamos conversar

Conte o que você precisa e responderemos em breve.

Agende uma demo

Escolha o dia e o horário. A reunião é pelo Google Meet e dura 30 minutos.

Dia
Horário · Horário do Chile (Santiago)

Buscando horários livres…