History / Troubleshooting

docs(wiki): migration-based start/update flow and restore (R4) Deployment: the start step now describes versioned migrations (build / baseline / apply) instead of db push, plus the first-start baseline and the stop on a mismatch. Troubleshooting: adopt the restore wording to migrations and add a section for the two deliberate start stops (schema mismatch, failed migration) plus the DB_MIGRATE_SKIP escape. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

DomeNinchen committed Oct 24, 2026

Deployment v0.14, Troubleshooting v1.24, Configuration v0.21: database backup before schema changes What the backend does at start (backup in data/backups/ before a schema change, DB_BACKUP_KEEP), restoring from such a copy, and the new variable. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

DomeNinchen committed Oct 23, 2026

Bot Flows v1.5, Troubleshooting v1.23: execution list in the flow editor Describes the editor's Executions panel (#319) and that running executions keep counting across off/on and save (#318); replaces the wrong "reachable from the flow list" in Troubleshooting. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

DomeNinchen committed Oct 23, 2026

Troubleshooting v1.22, Configuration v0.20: query debug log masks credentials (#315) Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

DomeNinchen committed Oct 22, 2026

Music Bots v0.17, Troubleshooting v1.21: Pause when alone is a switch now (#313) Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

DomeNinchen committed Oct 22, 2026

Deployment v0.11, Troubleshooting v1.20, Configuration v0.16, Development v0.5: the containers run unprivileged (PR 276) Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

DomeNinchen committed Oct 13, 2026

Wiki pass: seven new pages for the pages that had none, corrections to older ones New pages (all v0.1): Clients, Client Database, Files, Icons, Moderation (Bans, Complaints, Offline Messages), Server Logs, Virtual Servers and Instance. Changed: Home v0.15 (rows for the new pages), sidebar, Users and Roles v0.4 (what each role sees, managing users, own account/2FA, FRONTEND_URL for SSO), Administration v0.7 (Settings tab by tab, Connections, restart details, debug danger zone), Tokens and Passwords v0.3 (no longer a stub; the list shows keys, not "shown once"), Themes and Appearance v0.2 (language), Music Bots v0.16 (request history, command aliases), Development v0.4 (Node 22.22+, no React Flow, common watch/build), Configuration v0.14 (FRONTEND_URL defaults and role, QUERY_DEBUG), Troubleshooting v1.19, Dashboard v0.6, Channels v0.2, Getting Started v0.9, Privacy and Hosting v0.6, Query Console v0.2, Server Maintenance v0.2, Server and Channel Groups v1.1 (links to the new pages). Every statement checked against the code on main (backend 2.63.2, frontend 3.77.1) or the TeamSpeak server's own command docs; two known limitations are stated where the pages read fields TeamSpeak does not return (Offline Messages list, Instance flood ban time). Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

DomeNinchen committed Oct 9, 2026

Connection Journal v0.4: banning an address; Configuration v0.13 (IP_BANS_DISABLED), Deployment v0.8, Privacy and Hosting v0.5, Troubleshooting v1.18, Administration v0.6, Home v0.14, sidebar entry Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

DomeNinchen committed Oct 9, 2026

Connection Journal v0.3: the country of an address (offline GeoIP); Privacy and Hosting v0.4, Troubleshooting v1.17, Home v0.13, sidebar entry Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

DomeNinchen committed Oct 8, 2026

Connection Journal v0.2: who joins a TeamSpeak server; Getting Started v0.8, Privacy and Hosting v0.3, Troubleshooting v1.16, Administration v0.5, Home v0.12 Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

DomeNinchen committed Oct 8, 2026

Music Bots v0.14: pausing when nobody is there, ending an unwatched stream; Troubleshooting v1.15 Documents the per-bot "Pause when alone (minutes)" field (backend 2.60.0) and Settings -> Streaming "End the stream when nobody is watching (minutes)" (backend 2.58.0), both off by default. Sidebar entries and a Troubleshooting bullet for a bot or stream that stops by itself. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

DomeNinchen committed Oct 8, 2026

Visitor address behind a reverse proxy: TRUST_PROXY, Settings -> Network Deployment v0.7 (new section, Coolify bullet), Configuration v0.11 (TRUST_PROXY row), Administration v0.3 (Visitor address), Troubleshooting v1.14 (Too many attempts for everybody). Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

DomeNinchen committed Oct 8, 2026

Connections without an API key and connection changes without a restart: Setup (elsewhere or rented), Getting Started, Music Bots, Troubleshooting (Setup-Remote v0.7, Getting-Started v0.7, Music Bots v0.12, Troubleshooting v1.13) Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

DomeNinchen committed Oct 7, 2026

Music Bots and Troubleshooting: the bot card's connection state, and that giving up after 10 retries is final (Music Bots v0.11, Troubleshooting v1.12) - Music Bots: new section "When a bot can't connect" - connecting / retrying (countdown, Stop cancels) / failed, the reason shown in the server's own words, a failed Start shows it too. - Troubleshooting: the music bot entries now say that the card shows the reason, that the bot stops for good after the 10th failed retry (Start tries again), and that this applies to an unresolvable host as well; version notes for backend 2.52.2 / 2.53.0. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

DomeNinchen committed Oct 5, 2026

Music Bots and Troubleshooting: the "banned (flood prevention)" refusal and the Ignore Antiflood group (Music Bots v0.10, Troubleshooting v1.11) - Troubleshooting: what the refusal means (it is the server's flood protection, not a ban), how backend 2.52.2 handles it, and how to get a stuck bot in at once. - Music Bots: new section recommending a server group with b_client_ignore_antiflood for the bots (added after their first connection), what it covers (the bot's commands) and what it does not (the connection refusal). Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

DomeNinchen committed Oct 5, 2026

Music bots: a bot that drops out mid-track when the server is a hostname, and the unresolvable-host message (Troubleshooting v1.10) Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

DomeNinchen committed Oct 4, 2026

Files page: folder upload and the limits of a folder's ZIP download (Troubleshooting v1.9) Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

DomeNinchen committed Oct 4, 2026

Files page: what the picture preview refuses and why (Troubleshooting v1.8) Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

DomeNinchen committed Oct 4, 2026

Files page: the upload window flags umlaut names and offers a plain ASCII name (Troubleshooting v1.7) Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

DomeNinchen committed Oct 4, 2026

Files page: link the forum report for umlaut file names, note the warning before upload and the versions (Troubleshooting v1.6) Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

DomeNinchen committed Oct 4, 2026

Files page: umlaut names upload but cannot be downloaded (reproduced with the TeamSpeak client alone); a client download that hangs at 100 percent (Troubleshooting v1.5) Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

DomeNinchen committed Oct 4, 2026

Files page: umlaut names - say what is known (upload and manager download work, one TeamSpeak client reported file not found) (Troubleshooting v1.4) Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

DomeNinchen committed Oct 4, 2026

Files page: how to fix the HTTP 413 from a reverse proxy; umlaut names depend on the server (Troubleshooting v1.3, Deployment v0.6) Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

DomeNinchen committed Oct 4, 2026

Query Console: new page for the console and its live events (Query Console v0.1, Home v0.8, Getting Started v0.6, Setup same machine v0.6, Setup remote v0.6, Tips and Pitfalls v0.4, Troubleshooting v1.2, Deployment v0.5) Also corrects what the wiki said about SSH: it is needed not only for event-triggered bot flows but for chat-command triggers, the Files page and icon picker (WebQuery has no file-transfer commands) and, now, the console's live events. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

DomeNinchen committed Oct 4, 2026

Files page: document FILES_MAX_UPLOAD_MB, reverse-proxy settings for uploads and the Files troubleshooting (Configuration v0.9, Deployment v0.4, Troubleshooting v1.1) Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

DomeNinchen committed Oct 4, 2026

Flesh out Troubleshooting into a concrete symptom→cause→fix guide Replaces the stub's "planned content" with real, actionable sections: debug logging as the first tool; connection failures matched to the actual errors (ECONNREFUSED, invalid apikey 5122, the query-IP-allowlist reset, DNS); event/command triggers vs SSH (auth failure, the server-side query ban); a bot flow that does nothing (execution log, out-of-scope identity, the list-placeholder gotcha); music bot connection/playback and stale yt-dlp cookies; the sidecar's own failure modes for video; and how to read the server log viewer. Cross-links Tips and Pitfalls and the setup pages instead of duplicating them. Sidebar sub-links updated to the new sections.

DomeNinchen committed Sep 26, 2026

Wiki v0.2: structure, navigation and the first written pages Adds navigation plus thirteen pages. Fully written: Home, Getting Started, Permissions, Tips and Pitfalls, Users and Roles. The rest are scaffolded with a short orientation so no link leads nowhere. Permissions documents the five tiers, which layer wins, and the skip and negate flags - including that TeamSpeak's own documentation website states the override order incorrectly.

DomeNinchen committed Sep 16, 2026