2 Upgrade
ppfeiffer edited this page 2026-04-19 13:20:53 +02:00
This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

Upgrade Guide

This document describes changes that may affect users upgrading from previous versions.

Upgrading to v0.0.5

Automatische Config-Migration

Fehlende config.ini-Einträge werden beim ersten Start automatisch mit Standardwerten ergänzt. Es sind keine manuellen Änderungen nötig.

Neue Datenbanktabellen

Beim Start werden automatisch angelegt (falls noch nicht vorhanden):

  • web_users Benutzerkonten (inkl. Spalten status, email)
  • web_otps Einmalpasswörter für die Registrierung
  • web_invitations Einladungslinks

Erster Login

Beim ersten Aufruf des Web Interfaces ohne vorhandenen Benutzer erscheint der Setup-Wizard (/setup). Dort wird der erste Admin-Account angelegt.

SMTP für OTP-Mails (optional)

Selbstregistrierung per OTP erfordert eine SMTP-Konfiguration in [Web_Viewer]. Ohne SMTP legt der Admin Benutzer manuell in der Benutzerverwaltung an.


Upgrading from v0.7

Config Compatibility

Previous config files continue to work. The following legacy config formats are supported:

  • [Jokes] with joke_enabled / dadjoke_enabled — Migrated to [Joke_Command] and [DadJoke_Command] with enabled. Both formats work; consider updating to the new format.
  • [Stats] / stats_enabled, [Sports] / sports_enabled, [Hacker] / hacker_enabled, [Alert_Command] / alert_enabled — All support the legacy *_enabled key; the new enabled key is preferred.

Banned Users: Prefix Matching

[Banned_Users] uses prefix (starts-with) matching for banned_users entries. A banned entry "Awful Username" matches both "Awful Username" and "Awful Username 🍆". If you rely on exact matching, ensure your banned entries are specific enough.

New Optional Sections

  • [Feed_Manager] — If you use RSS/API feeds, add this section. If absent, the feed manager is disabled. New installs and minimal configs include [Feed_Manager] with feed_manager_enabled = false.
  • [Path_Command] — New options like path_selection_preset, enable_p_shortcut (default: true), and graph-related settings. Omitted options use sensible defaults.