Self-Hosting Erste Schritte

Dieser Guide führt dich durch ein Single-Host-Setup mit Docker-Compose. Lesezeit + Setup-Zeit: ~30 Minuten.

Voraussetzungen

Komponente	Version	Hinweis
Linux/macOS/Windows	aktueller Kernel	Windows: WSL2
Docker	≥ 24	mit Compose-V2
Node.js	≥ 20	für die `ay`-CLI
MongoDB	6 oder 7	als Container oder extern (Atlas)
Redis	≥ 7	als Container reicht
Storage	50 GB+	für Compose-Volumes
RAM	8 GB+	abhängig von aktivierten Profilen

Für ein Test-Setup reicht ein Mini-PC oder eine kleine VM (z.B. Hetzner CX31). Production sollte 16 GB+ haben.

CLI installieren

npm install -g @tolinax/ayoune-cli
ay --version            # 2026.x.y

Mehr unter CLI Install — die CLI ist der Türöffner für alle Self-Hosting-Operationen.

Setup-Wizard

ay setup

Der Wizard fragt dich der Reihe nach:

Hostname der Instanz (z.B. ayoune.firma.tld)
MongoDB-URL (mongodb://... oder mongodb+srv://...)
Redis-URL (redis://localhost:6379)
License-Key (Trial: leer lassen, du bekommst 14 Tage)
Profile — welche Domänen-Module starten? (core, crm, marketing, ...)
JWT-Secret (auto-generiert, aber überschreibbar)
TLS — Caddy (Let's-Encrypt), Traefik oder eigener Reverse-Proxy?

Nach Bestätigung schreibt der Wizard:

~/.aYOUne/
├── docker-compose.yml      # erzeugt aus deiner Auswahl
├── .env                    # Geheimnisse + Hosts
└── data/
    ├── mongo/
    └── redis/

Ersten Start

ay status                  # zeigt: alle services down
docker compose up -d       # ODER: ay local up
ay status                  # zeigt: services starting → healthy

Sobald alle Services healthy sind, erreichst du die Plattform unter https://<hostname>.

Initial-Login

Standard-Bootstrapping legt einen Superuser an:

ay setup bootstrap-superuser \
  --email admin@firma.tld \
  --password 'SehrSicher!2026'

Logge dich ein, lege deinen ersten Customer + die ersten User an. Mehr unter Admin-Handbook → Erste Schritte.

Häufige Stolpersteine

MongoDB-Replicaset: aYOUne nutzt Change-Streams — eine Standalone-MongoDB funktioniert NICHT. Mindest-Setup: rs0-Replicaset.
Redis-Persistence: Aktiviere AOF (appendonly yes) für Production — sonst gehen Queue-Jobs nach Restart verloren.
TLS: Ohne HTTPS keine PWA-Features (Service-Worker, Push-Notifications). Nutze Caddy oder einen vorgelagerten Reverse-Proxy.

Nächste Schritte

Docker-Compose — Profile verstehen
Environment Variables — Tuning
Upgrades — wie aktualisieren

Continuare a lavorare con questa pagina

Istruzioni pronte per il tuo strumento di IA. Copia, incolla e inizia: l’IA recupera il contenuto da sola tramite l’indirizzo indicato nel testo.

Riassumere i passaggi per me L’essenziale, nell’ordine giusto.

Apri in ChatGPT

Leggi la seguente documentazione di tolinax UG e lavoraci.

Questa pagina: https://ayoune.com/it/docs/self-hosting/getting-started.md
La raccolta completa: https://ayoune.com/it/docs/self-hosting.md

Riassumi il contenuto per me.

- Prima, in due frasi: di cosa si tratta?
- Poi i passaggi nell’ordine in cui devo affrontarli.
- Una riga per passaggio, in linguaggio semplice.
- Alla fine: che cosa dovrei avere pronto in anticipo.

Non tralasciare nulla che mi serva per arrivare davvero in fondo.
Nota sulle fonti:
- Ogni pagina di questa documentazione è disponibile come Markdown (lo stesso indirizzo con `.md`).
- Una panoramica leggibile da macchina di tutti i contenuti pubblici è su `/llms.txt`.
- Se hai accesso al server MCP di aYOUne, puoi lavorare su dati in tempo reale
  invece che su questa istantanea. Altrimenti ignora questo punto.

Spiegare a cosa mi serve A cosa serve e quando conviene.

Apri in ChatGPT

Leggi la seguente documentazione di tolinax UG e lavoraci.

Questa pagina: https://ayoune.com/it/docs/self-hosting/getting-started.md
La raccolta completa: https://ayoune.com/it/docs/self-hosting.md

Spiegami a cosa mi serve.

1. Quale problema risolve? In una frase, dal mio punto di vista.
2. Tre situazioni tipiche in cui mi aiuta davvero.
3. Quando NON mi serve: così risparmio tempo.
4. Che cosa posso fare invece, se non fa al caso mio.

Attieniti a quanto dice la fonte. Dove non dice nulla, dillo apertamente invece
di tirare a indovinare.
Nota sulle fonti:
- Ogni pagina di questa documentazione è disponibile come Markdown (lo stesso indirizzo con `.md`).
- Una panoramica leggibile da macchina di tutti i contenuti pubblici è su `/llms.txt`.
- Se hai accesso al server MCP di aYOUne, puoi lavorare su dati in tempo reale
  invece che su questa istantanea. Altrimenti ignora questo punto.

Aiutarmi con la configurazione Passo dopo passo, chiedendomi man mano.

Apri in ChatGPT

Leggi la seguente documentazione di tolinax UG e lavoraci.

Questa pagina: https://ayoune.com/it/docs/self-hosting/getting-started.md
La raccolta completa: https://ayoune.com/it/docs/self-hosting.md

Accompagnami passo dopo passo nella configurazione.

- Dimmi prima che cosa devo avere pronto (accessi, dati, tempo).
- Poi guidami UN passaggio alla volta. Aspetta il mio "avanti".
- Per ogni passaggio, indica come capisco che ha funzionato.
- Se qualcosa va storto, chiedimi il messaggio esatto invece di indovinare.

Se le istruzioni lasciano un punto aperto, dimmelo invece di inventarlo.
Nota sulle fonti:
- Ogni pagina di questa documentazione è disponibile come Markdown (lo stesso indirizzo con `.md`).
- Una panoramica leggibile da macchina di tutti i contenuti pubblici è su `/llms.txt`.
- Se hai accesso al server MCP di aYOUne, puoi lavorare su dati in tempo reale
  invece che su questa istantanea. Altrimenti ignora questo punto.

Aiutarmi con un problema Circoscrivere la causa invece di indovinare.

Apri in ChatGPT

Leggi la seguente documentazione di tolinax UG e lavoraci.

Questa pagina: https://ayoune.com/it/docs/self-hosting/getting-started.md
La raccolta completa: https://ayoune.com/it/docs/self-hosting.md

Aiutami a circoscrivere un problema.

- Chiedimi prima che cosa osservo e che cosa mi aspettavo.
- Da lì ricava le cause più probabili coerenti con questa fonte.
- Per ogni causa dammi UNA verifica che la confermi o la escluda.
- Ordinale in modo che la verifica più economica venga per prima.

Non tirare a indovinare. Se la fonte non copre il problema, dimmi dove dovrei
cercare ancora.
Nota sulle fonti:
- Ogni pagina di questa documentazione è disponibile come Markdown (lo stesso indirizzo con `.md`).
- Una panoramica leggibile da macchina di tutti i contenuti pubblici è su `/llms.txt`.
- Se hai accesso al server MCP di aYOUne, puoi lavorare su dati in tempo reale
  invece che su questa istantanea. Altrimenti ignora questo punto.

Spiegarlo con parole semplici Senza termini tecnici, da zero.

Apri in ChatGPT

Leggi la seguente documentazione di tolinax UG e lavoraci.

Questa pagina: https://ayoune.com/it/docs/self-hosting/getting-started.md
La raccolta completa: https://ayoune.com/it/docs/self-hosting.md

Spiega il contenuto in modo che lo capisca chi non ha conoscenze pregresse.

- Parti dallo scopo: perché esiste tutto questo?
- Spiega i termini tecnici in mezza frase alla prima occorrenza.
- Un paragone quotidiano dove regge davvero, nessuno dove zoppica.
- Alla fine: le tre cose da ricordare.

Non accorciare omettendo condizioni. Una semplificazione che nasconde un
prerequisito è un’affermazione falsa.
Nota sulle fonti:
- Ogni pagina di questa documentazione è disponibile come Markdown (lo stesso indirizzo con `.md`).
- Una panoramica leggibile da macchina di tutti i contenuti pubblici è su `/llms.txt`.
- Se hai accesso al server MCP di aYOUne, puoi lavorare su dati in tempo reale
  invece che su questa istantanea. Altrimenti ignora questo punto.

Una lista da spuntare Da seguire mentre procedi.

Apri in ChatGPT

Leggi la seguente documentazione di tolinax UG e lavoraci.

Questa pagina: https://ayoune.com/it/docs/self-hosting/getting-started.md
La raccolta completa: https://ayoune.com/it/docs/self-hosting.md

Trasformalo in una **lista di controllo** da spuntare per la pratica.

- Esattamente un’azione per punto, all’imperativo.
- Ordinala in modo che nessun punto dipenda da un prerequisito successivo.
- Prerequisiti e insidie come sotto-punti rientrati.
- Chiudi con una verifica finale: come faccio a sapere che è tutto corretto?
Nota sulle fonti:
- Ogni pagina di questa documentazione è disponibile come Markdown (lo stesso indirizzo con `.md`).
- Una panoramica leggibile da macchina di tutti i contenuti pubblici è su `/llms.txt`.
- Se hai accesso al server MCP di aYOUne, puoi lavorare su dati in tempo reale
  invece che su questa istantanea. Altrimenti ignora questo punto.

Was this article helpful?

👎 No (0)