Anfangen · Kapitel 1
Das erste Konto.
nexcrate läuft als ein einziger Container auf deinem eigenen Server. Dieses Kapitel beginnt dort, wo der Container schon läuft, und führt bis zum angelegten Konto und zu den zwei Handgriffen, die du gleich danach erledigst. Wie du den Container startest, welche Ordner du einbindest und welche Umgebungsvariablen es gibt, steht auf der Seite Selbst hosten.
Was du brauchst
- Einen laufenden nexcrate-Container. Ab Werk antwortet er unter
http://adresse-des-servers:8390. - Einen Browser am Rechner, am Tablet oder am Handy.
- Eine Authenticator-App auf dem Handy, wenn du den zweiten Faktor einschalten willst. Genannt werden in der App zum Beispiel Aegis, 2FAS oder dein Passwortmanager.
Das Konto anlegen
Beim ersten Aufruf zeigt nexcrate die Seite „Willkommen bei nexcrate“. Das Konto, das du hier anlegst, ist das einzige, das es gibt. Es gehört dem Betreiber, also dir.
Gut zu wissenSolange das Konto nicht angelegt ist, kann es jeder anlegen, der die Seite öffnen kann. Das lässt sich nicht anders lösen, denn es gibt noch kein Konto, das sich ausweisen könnte. Leg es deshalb gleich nach dem ersten Start an, bevor der Port aus anderen Netzen erreichbar ist.
- Sprache wählen
Oben rechts wählst du zwischen „Deutsch“ und „English“. Ab Werk beginnt nexcrate in der Sprache deines Browsers, wenn es sie kennt, sonst auf Englisch. Die Sprache, die du jetzt wählst, wird auch die Sprache deines Kontos.
- Benutzername und Passwort eintragen
Der „Benutzername“ darf höchstens 64 Zeichen lang sein. Das „Passwort“ braucht mindestens 8 Zeichen, und bei „Passwort wiederholen“ tippst du es noch einmal ein. Stimmen die beiden nicht überein, sagt nexcrate es dir, bevor etwas angelegt wird.
- „Konto anlegen“ wählen
Danach bist du angemeldet, und die Einrichtung ist für immer zu. Der Weg zu ihr lässt sich nicht noch einmal öffnen.
Die Seite sagt es dir noch einmal in einem eigenen Kasten: „Es gibt nur dieses eine Konto“. Sobald es existiert, kann niemand ein weiteres anlegen, auch du nicht. Wünsche von Familie und Freunden nimmt deshalb nicht nexcrate an, sondern Nexview, das davor steht.
Hattest du nexcrate schon einmal, steht unter dem Formular „Aus einer Sicherung starten“. Damit beginnt die neue Installation mit dem Stand einer heruntergeladenen Sicherung statt leer, und das Konto kommt aus der Sicherung. Das Kapitel Sicherung beschreibt den Weg.
Die Sprache später ändern
Die Sprache der Oberfläche stellst du jederzeit unter „Einstellungen › System › Konto“ ein, bei „Sprache der Oberfläche“. Sie gilt auf jedem Gerät, auf dem du dich anmeldest. Es gibt Deutsch und Englisch.
Den zweiten Faktor einschalten
Ab Werk öffnet das Passwort allein nexcrate. Im eigenen Netz ist das vertretbar, aus dem Internet nicht. Der zweite Faktor ist freiwillig: Nach dem Passwort fragt nexcrate zusätzlich nach einem Code aus einer Authenticator-App.
- Einschalten
Öffne „Einstellungen › System › Konto“. Im Abschnitt „Zweiter Faktor“ steht „Ausgeschaltet. Das Passwort allein öffnet nexcrate.“ Wähle „Einschalten“.
- Den Code scannen
Scanne den QR-Code mit deiner Authenticator-App. Geht das nicht, tippst du den Schlüssel ein, der darunter steht. Den QR-Code zeichnet dein eigener Server.
- Bestätigen
Trag den Code, den die App jetzt zeigt, bei „Code aus der App“ ein, dazu dein „Passwort“, und wähle „Einschalten bestätigen“.
- Die Wiederherstellungscodes aufheben
nexcrate zeigt jetzt acht „Wiederherstellungscodes“ und nur dieses eine Mal. Jeder öffnet nexcrate genau einmal, falls das Handy fehlt. Speichere sie mit „Als Datei speichern“, hebe sie getrennt vom Handy auf und wähle „Gespeichert, fertig“.
Bei der nächsten Anmeldung fragt nexcrate nach dem Passwort und danach nach dem Code. Unter „Neue Wiederherstellungscodes“ erzeugst du später frische, dann gelten die alten nicht mehr. Meldest du dich über einen Anmeldeanbieter wie authentik an, zählt dessen zweiter Faktor, solange du dem Anbieter dafür vertraust. Das Kapitel Anmeldung erklärt das.
Passwort oder Handy verloren
Es gibt ein Konto und keinen zweiten Weg hinein. Deshalb liegt der Ausweg beim Server: Wer ihn bedienen kann, setzt ein neues Passwort. Dazu öffnest du eine Shell auf dem Rechner, auf dem nexcrate läuft.
docker exec -it nexcrate python -m app.cli reset-passwordDer Befehl fragt zweimal nach dem neuen Passwort, ohne es anzuzeigen, und beendet danach jede Sitzung. Melde dich dann mit dem neuen Passwort an.
Sind das Handy und mit ihm die Wiederherstellungscodes weg, schaltet ein zweiter Befehl den zweiten Faktor aus. Danach richtest du ihn wie oben neu ein.
docker exec -it nexcrate python -m app.cli reset-second-factorEin Passwort, das du kennst und nur ändern willst, änderst du bequemer in der Oberfläche: „Einstellungen › System › Konto“, „Passwort ändern“. Danach sind alle anderen Geräte abgemeldet. „Überall abmelden“ beendet die Anmeldung auf allen Geräten, auch auf diesem. Das hilft, wenn du dich an einem fremden Gerät nicht abgemeldet hast.
Gut zu wissenIst die Anmeldung mit Passwort für deine Anbieter ausgeschaltet und kein Anbieter erreichbar, öffnet die Umgebungsvariable NEXCRATE_PASSWORD_LOGIN=1 sie wieder. Setz sie in der Compose-Datei, starte den Container neu, melde dich an und nimm die Variable danach wieder heraus.
Als Nächstes braucht nexcrate den Zugang zu TMDB. Das nächste Kapitel, TMDB, holt den kostenlosen Token.