Argunis/On-premise/Install

Install Argunis on your server

One command installs Docker, Portainer and Argunis, and at the end shows you the addresses and passwords.

Server requirements

A server (physical or virtual) dedicated to Argunis. The installer checks all of this before starting and tells you what is missing.

  • System: Ubuntu 22.04, Ubuntu 24.04 or Debian 12, 64-bit: x86_64 (Intel or AMD) or ARM (aarch64, ARMv8.2 or newer: AWS Graviton, Ampere, Raspberry Pi 5 or a VM on an M-chip Mac). The command is the same; the server only downloads the images for its architecture.
  • CPU: 4 at least.
  • Memory: 12 GB of RAM at least. With 12 GB the local AI uses a 4B model and with 16 GB or more a 7B one, which answers better. No GPU needed.
  • Disk: 100 GB free on SSD.
  • Internet: HTTPS egress (port 443) to api.argunis.com, ws.argunis.com, argunis.com, ghcr.io and registry-1.docker.io (software), and registry.ollama.ai (AI model, the first time).
  • Free ports: 80 and 443 (Argunis), 8443 (agents) and 9443 (Portainer). If 443 is taken, the installer picks another free one and shows you the exact address at the end.
  • Access: a user with administrator rights (sudo) and a way to connect by SSH or through the virtual machine console.

Step-by-step installation

You do not need to know Docker. It takes 15 to 40 minutes depending on your connection.

  1. Request your trial key

    Fill in the form and confirm your email. You will see your JTRL-… key once and it also arrives by email: keep it, you will use it in step 4.

  2. Connect to the server

    Open a terminal (Windows: PowerShell; Mac and Linux: Terminal) and type this command, replacing usuario with your server user and 192.168.1.50 with its IP.

    The first time it asks whether you trust the server: type yes and press Enter.

  3. Paste the installer command

    Paste it in the server terminal and press Enter. It will ask for your administrator password.

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

    At the end you will see the Argunis address and the Portainer user and password. Write the password down: it is shown only once (it stays in /opt/argunis/acceso.txt, administrators only).

  4. Open Argunis and complete the wizard

    In your browser open https:// and the server IP, for example https://192.168.1.50. The browser will warn about a non-private connection because Argunis uses your server’s own certificate:

    • Chrome or Edge: Advanced → Proceed to the site.
    • Firefox: Advanced… → Accept the risk and continue.
    • Safari: Show details → visit this website.

    Paste your JTRL-… key and fill in your company details, email (SMTP) and your administrator user with its second factor (MFA).

  5. Manage it with Portainer

    Open https://192.168.1.50:9443 and sign in with the user admin and the password the installer showed. In Stacks → argunis-onpremise you see each service, its logs and can restart them.

If something fails

Run the installer again

Paste the same command again: it resumes where it stopped and repairs what is missing, without losing data or changing keys.

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

Check the status

In Portainer or in the terminal. Postgres and ClickHouse stay “waiting” until you activate the key: this is normal.

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

Recover the access details

Addresses, Portainer user and password, and the installation log:

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

Update to a new release

When we announce a new release, keep your data and keys:

curl -fsSL https://argunis.com/instalar.sh | sudo bash -s -- --actualizar
  • “Cannot reach …”: the firewall or proxy blocks egress to that name on port 443. Ask to open it and try again.
  • “Not enough memory, disk or CPU”: enlarge the virtual machine and try again.
  • Your own certificate: copy your certificate and key as /opt/argunis/tls/tls.crt and tls.key (owner 101) and restart the web service in Portainer.
  • Still having problems? Write to [email protected] with the error message and the file /opt/argunis/instalador.log.

Downloads of the current release

Each file with its SHA-256 so you can verify it. Images are pinned by digest in docker-compose.yml. Releases

Loading the current release…

To review the installer before running it: download it, compare its SHA-256 with the table and run it.

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

Install manually in your own Portainer

For teams that already run Docker and Portainer. Otherwise, use the installer above: it does all of this on its own.

  1. Prepare the server

    Encrypted-disk modules, /opt/argunis folders, shared mount and the seccomp profile of the test browser:

    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. Create the HTTPS certificate

    Self-signed (or copy yours as tls.crt and 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. Generate the variables file (.env)

    The same installer generates every key without installing anything. Keep a copy outside the server: without those keys the data cannot be opened.

    curl -fsSL https://argunis.com/instalar.sh | bash -s -- --solo-generar-env argunis.env
  4. Create the stack in Portainer

    Stacks → Add stack, name argunis-onpremise: paste the release docker-compose.yml and, in Environment variables → Advanced mode, the content of argunis.env.

Let’s talk

Tell us what you need and we will get back to you shortly.

Book a demo

Choose a day and time. The meeting is on Google Meet and lasts 30 minutes.

Day
Time · Chile time (Santiago)

Looking for free times…