argos-setup/README.md

# ARGOS SOC — Setup & Installer

Tecnotel Servizi SRL — [www.tecnotelsrl.com](https://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:

```bash
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:

```bash
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`](https://argos-update.tecnotelsrl.com/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`).