argos-setup/README.md

ARGOS SOC — Setup & Installer

Tecnotel Servizi SRL — www.tecnotelsrl.com

Repository pubblico contenente l'installer di prima fase e il Web Setup Wizard di ARGOS SOC.

Installazione rapida (one-liner)

Su una macchina Ubuntu 24.04 LTS vergine, esegui:

curl -fsSL https://argos-update.tecnotelsrl.com/tecnotel/argos-setup/raw/branch/main/bootstrap.sh | sudo bash

Il bootstrap scaricherà il repository e avvierà first-setup.sh.

Installazione manuale

Se preferisci eseguire gli step separatamente:

sudo apt update && sudo apt install -y git
git clone https://argos-update.tecnotelsrl.com/tecnotel/argos-setup.git /opt/argos-setup-pkg
cd /opt/argos-setup-pkg
sudo bash first-setup.sh

Contenuto

File	Scopo
bootstrap.sh	One-liner installer: scarica il repo e avvia first-setup.sh
first-setup.sh	Installer ambiente base: sistema, utenti, firewall, nginx temp, avvia wizard web
setup_server.py	Backend Python del Web Installer (porta 8888, self-contained)
setup.html	Frontend del Web Installer — wizard in 6 step
gen_config.py	Helper per generazione iniziale di argos.json

Flusso d'installazione

1. Il cliente esegue il bootstrap (o il clone manuale + first-setup.sh).
2. first-setup.sh predispone l'ambiente base Ubuntu 24.04 (pacchetti, utente argos, cartelle, firewall) e avvia il Web Installer su http://IP:8888.
3. Il cliente apre il browser e segue il wizard in 6 step:
   1. Licenza ARGOS — il wizard mostra il machine_id di questo server. Il cliente lo invia a Tecnotel, riceve license.json, lo carica nel wizard.
   2. Informazioni cliente (nome, dominio, logo)
   3. Rete & SSL (hostname, certificato)
   4. SIEM (OpenSearch)
   5. Utente admin
   6. Riepilogo & Installazione — il wizard clona il repository privato tecnotel/argos usando il token della licenza, crea virtualenv, configura servizi e avvia ARGOS SOC.

Al termine il Web Installer viene disattivato automaticamente e la porta 8888 chiusa.

Requisiti

• Ubuntu 24.04 LTS (verificato dallo script)
• Accesso root (sudo)
• Connessione internet verso argos-update.tecnotelsrl.com
• Una licenza ARGOS valida emessa da Tecnotel per il machine_id del server

Repository correlati

• tecnotel/argos — codice runtime di ARGOS SOC (privato, accessibile solo con licenza).

Versioning

Questo repository segue lo stesso schema di versioning di argos (SemVer tag vX.Y.Z).