---
name: Aria Onboarding Checkliste
title: ONBOARDING — Erste-Boot-Checkliste (Distributions-Template)
description: Erste-Boot-Checkliste die Aria mit dem User nach Install gemeinsam durchgeht. Wird vom onboarding-Skill abgearbeitet, danach status auf done.
type: system
tags: [onboarding, system, first-boot]
date: 2026-05-06
status: done
---

> **status → done (08.07.2026, KAR-884):** Pflicht-Setup (1–4) ist seit Monaten erledigt und produktiv; `status: pending` war ein latenter Fehltrigger für den onboarding-Skill. Offene Optional-Items (5–12) laufen über Linear, nicht über diese Checkliste. Datei bleibt als Distributions-Template.

# Aria Onboarding — fuer Kais

Hi Kais, ich bin Aria. Aria-Code ist installiert auf deinem VPS, jetzt richten wir die Services ein die ich brauche um dir wirklich zu helfen.

Wir gehen das Step-by-Step durch. Du sagst „naechster", wenn du fertig bist. Wenn du was ueberspringen willst: „skip $service".

## Pflicht (ohne lauft Aria nur eingeschraenkt)

### 1. GitHub PAT
Damit ich Code-Aenderungen + Backup-Sync machen kann.
- Geh zu github.com/settings/personal-access-tokens/new
- „Fine-grained personal access token"
- Resource owner: dein User
- Repository access: All / oder spezifische
- Permissions: Contents (Read+Write), Metadata (Read), Pull requests (Read+Write)
- Expiration: 90 Tage
- Token an mich per Telegram

### 2. Anthropic-Login
Du wurdest beim Installer schon eingeloggt. Falls nicht: `claude login`.

### 3. Telegram-Bot ist da
Du hast ihn beim Installer bei @BotFather angelegt. Schreib mir „Hi" → ich antworte → Check ✓

## Empfohlen

### 4. Supabase Chat-Log
Damit ich nach Restarts den Chat-Verlauf wiederherstellen kann.
- Account auf supabase.com (Free-Tier reicht)
- Neues Projekt „aria-kais", Region Frankfurt
- Settings → API → Project URL, Anon-Key, Service-Role-Key kopieren
- An mich per Telegram (alle 3)
- Ich richte die `aria_chat_log` Tabelle automatisch ein

### 5. Obsidian (Brain-Editor)
Damit du dein Brain visuell siehst und editieren kannst.

**Auf deinem Rechner installieren:**
- obsidian.md Desktop-App fuer dein OS (Win, Mac, Linux)
- Optional: Obsidian Mobile (iPhone/Android)

**Brain-Sync zwischen VPS und deinem Rechner:**

a) **Git Sync (empfohlen, kostenlos):**
   - Auf deinem Mac: `xcode-select --install` (installiert git)
   - Auf deinem Win: git fuer Windows installieren (git-scm.com/download/win)
   - Ich richte ein privates GitHub-Repo `aria-brain-kais` ein und committe regelmaessig
   - Du clonst das Repo auf deinen Rechner: `git clone <repo-url> ~/Documents/aria-brain`
   - In Obsidian: „Open folder as vault" → den geclonten Folder waehlen
   - Sync-Trigger: Aria committet auf VPS, du machst `git pull` auf Rechner (oder Obsidian-Git-Plugin)

b) **Obsidian Sync (4€/Mo, einfacher):**
   - Account auf obsidian.md/sync, Sync-Vault einrichten
   - Auf VPS aria-brain als gesyncter Vault konfigurieren
   - Auf Mac/Win/Mobile selber Vault verbinden

c) **iCloud / Dropbox:**
   - Brain-Folder via Cloud-Sync replizieren
   - Etwas fragil bei concurrent edits, nur empfohlen wenn (a)/(b) zu komplex

Sag mir welche Variante, dann richte ich es ein.

### 6. n8n Workflow-Engine

Damit ich Workflows ausfuehren kann (Daily-Briefing, Backups, Social-Media-Cron, Mailing-Sequences).
- n8n laeuft schon nach Install auf http://VPS-IP:5678 (Container `aria-n8n`)
- Erster Aufruf: Admin-Account anlegen (Email + Password)
- Optional spaeter: hinter Reverse-Proxy mit eigenem Subdomain (n8n.deine-domain.com via Caddy/Traefik)
- Workflow-Templates importieren von aria-v4 Repo `n8n/workflows/` (sobald angelegt)

### 7. Google Workspace (Gmail + Calendar + Drive)
Damit ich Mails triagen + Termine sehen kann.
- Wir richten OAuth ein. Du klickst durch einen Google-Login.
- Befehl: `bash ~/aria/scripts/setup_google_auth.py`
- Folge den Anweisungen.

## Optional (nach Bedarf)

### 8. Vercel
Falls du Sites/Apps auf Vercel hostst.
- vercel.com → Account-Settings → Tokens → Generate
- An mich per Telegram

### 9. Linear
Falls du Linear fuer Projektmanagement nutzt.
- linear.app → Settings → API → Personal API Keys → New
- Workspace-Slug + API Key an mich per Telegram

### 10. X / Twitter (Posting)
Falls du via Aria posten willst.
- developer.x.com Account
- API Key, API Secret, Access Token, Access Secret, Bearer Token
- An mich per Telegram

### 11. LinkedIn (Posting)
Komplexer (OAuth-Flow), machen wir wenn du es brauchst.
- Sag „LinkedIn einrichten" wenn du soweit bist.

### 12. Stripe (Revenue-Reads)
Falls du Stripe nutzt.
- dashboard.stripe.com → Developers → API keys → Restricted Key (read-only)
- An mich per Telegram

## Status

- [x] 1. GitHub PAT
- [x] 2. Anthropic-Login
- [x] 3. Telegram-Bot
- [x] 4. Supabase Chat-Log
- [ ] 5. Obsidian + Brain-Sync
- [ ] 6. n8n Workflow-Engine
- [ ] 7. Google Workspace
- [ ] 8. Vercel
- [ ] 9. Linear
- [ ] 10. X/Twitter
- [ ] 11. LinkedIn
- [ ] 12. Stripe

Sag „erledigt 1" / „erledigt 4" / etc. wenn du was abgehakt hast. Ich aktualisiere diesen File.

Wenn alles durch (Pflicht + Empfohlen): ich aendere status oben auf `done`.