VAULTHandbuch
deen

Der Einrichtungs-Assistent

Sechs Schritte im Browser — vom leeren Server zum offenen Shop, in etwa fünf Minuten.

Nach der Installation öffnest du https://deine-domain.de/install. Der Assistent ist wiederaufnehmbar: Schließt du den Browser bei Schritt vier, landest du beim nächsten Besuch wieder bei Schritt vier. Jeder Integrationsschritt lässt sich überspringen und später im Admin-Bereich nachholen.

Die sechs Schritte

  1. 1

    Install-Token

    Der Token aus dem Terminal. Einmal richtig eingegeben, ist der Assistent für dich freigeschaltet — und für niemanden sonst.

  2. 2

    System check

    Sieben Prüfungen gegen deinen Server: Node-Version, Datenbank, Schema, Dateispeicher, Verschlüsselungs-Schlüssel, ausgehendes HTTPS, Store-URL. Alles Rote nennt seinen konkreten Fix; Gelbes blockiert nicht.

  3. 3

    Database

    Zeigt Datenbank und Schema-Stand. Migrationen laufen beim Containerstart automatisch — normalerweise gibt es hier nichts zu tun.

  4. 4

    Admin account

    Dein Betreiber-Konto: Name, E-Mail, Passwort (mindestens 10 Zeichen). Mit dieser E-Mail meldest du dich künftig unter /sign-in an.

  5. 5

    Store basics

    Shopname, Währung, Standardsprache, Zeitzone. Alles später unter Settings änderbar.

  6. 6

    Integrations & Finish

    Optional: SMTP-Zugang (mit Testmail-Knopf) und Stripe-Schlüssel (wird live geprüft). Danach die Zusammenfassung — „Finish setup" schließt den Assistenten endgültig und bringt dich ins Admin-Panel.

Wenn etwas klemmt

  • Ein falscher Token sagt es dir klar — er steht in .env (grep INSTALL_TOKEN .env) und im Container-Log.
  • Bleibt eine Einrichtung hängen, ist pnpm reset:install der dokumentierte Weg zurück auf Anfang (löscht nur den Assistenten-Zustand, keine Bestellungen).
  • Rote Checks: jede Zeile nennt ihren Fix. Die häufigste Ursache ist eine falsche APP_URL in .env.

Geschafft — weiter mit den ersten Schritten im Admin-Bereich.