docs: data folder recovery names the console's account; superseded rows marked

The Windows README removed only the prompt's own account from a data folder
created by an unelevated console run, which missed a console run by a
standard user. It now removes the account the service's refusal names.
The DECISIONS rows on OneDrive sync roots and on the service's start-up
log say which later rows partly supersede them.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012iLMBNwBE2GnphAsu4cjaC
This commit is contained in:
Claude committed 2026-10-12 19:25:32 +00:00
1 parent dbbb5079d1
commit d5f9dabf63
2 files changed
+13 -11

No files matched your search

+11 -9
View File
@@ -128,15 +128,17 @@ accounts and read by other users; when other users can change an existing archiv
Run `Titano.Server.exe` in a console, or install it as a Windows service from an administrator prompt with
`Titano.Server.exe --install-service` (remove it with `--uninstall-service`). The service runs as LocalSystem, so it
registers only from a copy inside `Program Files` that only administrators can change: install for *All users*, or
unpack the zip into a folder under `Program Files`. A console run that was not elevated creates the data folder as your
own account, and the service then refuses it. Either delete the folder (with SQLite this also deletes the server's
database and its accounts), or, before you start the service, give the folder and everything in it to Administrators
and take your account's access to it away, from a Command Prompt run as administrator under that same account:
`takeown /F "C:\ProgramData\Titano Server" /A /R`, then
`icacls "C:\ProgramData\Titano Server" /remove:g "%USERDOMAIN%\%USERNAME%" /T`. No other account gains access at any
step, and afterwards only SYSTEM and Administrators have it, to the TLS key and `initial-admin-password.txt` too. Do
not reset the folder's permissions (`icacls /reset`): everything in it would then inherit those of `C:\ProgramData`,
which let every user read it.
unpack the zip into a folder under `Program Files`. A console run that was not elevated creates the data folder as the
account that ran it, and the service then refuses the folder and names that account (`… belongs to PC\name …`).
Either delete the folder (with SQLite this also deletes the server's database and its accounts), or give the folder
and everything in it to Administrators and take that account's access to it away, from a Command Prompt run as
administrator: `takeown /F "C:\ProgramData\Titano Server" /A /R`, then
`icacls "C:\ProgramData\Titano Server" /remove:g "PC\name" /T`, with the account the refusal names in place of
`PC\name` (`dir /q C:\ProgramData` also shows it, as the folder's owner, until `takeown` runs). When you ran the
console yourself and the prompt runs as you, that account is `"%USERDOMAIN%\%USERNAME%"`. Then start the service. No
other account gains access at any step, and afterwards only SYSTEM and Administrators have it, to the TLS key and
`initial-admin-password.txt` too. Do not reset the folder's permissions (`icacls /reset`): everything in it would then
inherit those of `C:\ProgramData`, which let every user read it.
## Translations
+2 -2
View File
@@ -350,7 +350,7 @@ One line per decision: date · decision · alternative · reason.
| 2026-10-12 | While the open archive's archive.json cannot be read, Settings › Archive shows the index's templates and proxy size and keeps this PC's thumbnail size, which the index does not store. | Show and save the default thumbnail policy | The stand-in 320 replaced the user's default for new archives whenever the archive was offline. |
| 2026-10-12 | An Archive row edited (or Reset section) while the archive at a just-chosen folder is opening waits for that open. The edit then goes to the archive registered at that folder, or stays this PC's default when the folder holds none. An edit made before a later folder change still goes to the folder it was made for, and the rows show the archive at the folder chosen last. | Disable the Archive rows while the folder opens | The edit is neither lost silently nor written into another archive's shared archive.json. Nothing is disabled under the user's typing, where a field losing focus would commit anyway. |
| 2026-10-12 | Start with Windows (client and Uploader) shows as on only while Task Manager has not turned the entry off, i.e. its StartupApproved\Run value does not have an odd first byte. The client reads it again when Settings is shown, the Uploader when its settings panel opens. Ticking the box deletes that value, unticking deletes it with the Run value, and re-pointing the command after a rename keeps it. Setup removes the value together with the Run value when it removes the entry (see the Task Manager state row below). | Read only the Run value; write 0x02 instead of deleting the marker | Task Manager keeps the Run value when it disables an entry, so the box stayed ticked and could not turn the entry back on. With no marker, Windows runs the entry. |
| 2026-10-12 | A portable copy whose .\data would lie in a folder OneDrive synchronises keeps its data in %LOCALAPPDATA%\Titano. Sync roots come from the OneDrive environment variables and HKCU\Software\Microsoft\OneDrive\Accounts, matched by whole path segments, ignoring case. The copy otherwise stays portable (portable-zip updates, no sign-in entry) and shows a toast at every start (Data kept outside OneDrive, with Open). It then shares the data folder and the single instance with an installed copy of the same user. The Uploader keeps .\data, since its files are JSON written atomically. Other sync tools are not detected. | Refuse to start; a separate per-copy folder under %LOCALAPPDATA%\Titano | BRIEF §6.2 forbids synchronised folders and names the per-user folder as the location. A copy that refused to start would leave the user with nothing. |
| 2026-10-12 | (Partly superseded by the SyncEngines mount point row below: sync roots also come from HKCU\Software\SyncEngines\Providers\OneDrive\*\MountPoint.) A portable copy whose .\data would lie in a folder OneDrive synchronises keeps its data in %LOCALAPPDATA%\Titano. Sync roots come from the OneDrive environment variables and HKCU\Software\Microsoft\OneDrive\Accounts, matched by whole path segments, ignoring case. The copy otherwise stays portable (portable-zip updates, no sign-in entry) and shows a toast at every start (Data kept outside OneDrive, with Open). It then shares the data folder and the single instance with an installed copy of the same user. The Uploader keeps .\data, since its files are JSON written atomically. Other sync tools are not detected. | Refuse to start; a separate per-copy folder under %LOCALAPPDATA%\Titano | BRIEF §6.2 forbids synchronised folders and names the per-user folder as the location. A copy that refused to start would leave the user with nothing. |
| 2026-10-12 | The .\data a portable copy now in a OneDrive folder used before (a titano.db or settings.json in it) is left as it is: the log and a toast at every start (Earlier data unused, with Open) name it. Nothing is copied, moved or deleted. | Move or copy it into %LOCALAPPDATA%\Titano at start | Moving an index is a destructive operation (dry-run plan, hash verification, explicit user action), and the per-user folder may already hold an installed copy's index; the user decides which to keep. |
| 2026-10-12 | When %LOCALAPPDATA%\Titano itself lies in a OneDrive sync root, the client starts all the same, logs a warning and shows an error toast at every start (Data inside OneDrive, with Open; its tooltip says to exclude the folder from syncing) instead of Data kept outside OneDrive. AppPaths.CreateDirectories, which refuses such a folder, stays unused by the client. | Refuse to start | BRIEF §6.2 names no safer place than the per-user folder; a client that does not start leaves the user nothing, while the warning lets them fix the sync setup. |
| 2026-10-12 | A photo an import could not copy shows one catalog sentence beside it on the Import screen and in the import job's log (`ImportExecutor.FailureText`: the executor's own checks, a full destination, access denied, else 'The photo could not be read or copied.'). So does a card file the plan cannot read ('Cannot read {0}: {1}'). The photos a stopped folder or server import never reached show the stop's cause (`ImportFailures.Stop`: the server's own sentence, not answering, untrusted certificate, card gone, destination full or not writable), and a failed index check reads `Archive.Failed.Index`. The system's text goes to the application log only. | Keep `ex.Message` beside each photo, or move it into each line's tooltip | BRIEF §0.2 rules 5–6, as for toasts (2026-10-12): framework and OS messages are technical English under a translated screen, and each failure is already logged with its exception. |
@@ -358,7 +358,7 @@ One line per decision: date · decision · alternative · reason.
| 2026-10-12 | Picking another archive, or the shown archive leaving the index, also clears the previous archive's tiles, charts, last scan, recent runs and rail badge, and its read state, until the new archive is read. Picking the first archive again before that read ends does not count it as read either | Keep them until the read ends and clear them only when it fails; a loading state drawn over the old figures | Probing an offline NAS takes seconds and a failed read never replaces anything, so the old figures stood under the new archive's name. An empty overview is the simplest honest state. |
| 2026-10-12 | A finished render is announced once, by whoever claims it first (`JobsViewModel.ClaimRenderToast`). The Jobs screen yields while the open editor still follows the render (`EditorViewModel.FollowsRender`). That editor announces it with the output and Show in folder. Without them, it still announces it when the sequence cannot be read again or when it closed in between. A render no editor follows is announced by the Jobs screen | The Jobs screen stays silent whenever an editor has the sequence open; first come, first served | The editor only announced renders it saw running, and only after reading the sequence again, so a failed read or an unfollowed render got no completion toast, against the job-ending rule (2026-10-12). The order of the Jobs flush and the editor's callback is not fixed, so 'first' alone could lose the output file. |
| 2026-10-12 | Open on a job that worked on several sequences (toast, Windows notification, Jobs row) shows the Library with every one of them selected under the mass actions bar. Search and filters are cleared when they hide one, and pages are read until each is listed. A job over more sequences than a Library page (200, e.g. Rebuild proxies over an archive) opens the Library as it is | Open the first in the editor; lead to the Jobs screen; a Library filter by job; select every target of any job | One editor holds one sequence. The selection is what the job was started from and its results show on the cards; it needs no new filter chip or strings. Looking up, paging through and selecting a whole archive would hold the UI thread for seconds. |
| 2026-10-12 | When the Windows service fails to start or stop, it writes the reason to the Application event log as source `TitanoServer` (advapi32 `ReportEventW`; event 1 start, event 2 stop) as well as to stderr. The reason comes first (the refused entry), then the exception. The source is not registered with a message file. The Windows README says where to look. It also says how to fix a data folder created by an unelevated console run: delete it (with SQLite, the database goes with it), or `takeown /A /R` and `icacls /reset /T` it from an administrator prompt, after which the server makes it private again. | Register the source at `--install-service` with .NET Framework's EventLogMessages.dll; `System.Diagnostics.EventLog`; a log file outside the data folder; re-own only the folder | A service has no console, and the data folder refusal comes before the log file exists (the log folder may itself be the refused entry), so the SCM recorded only error 1064. Event Viewer shows an unregistered source's text whole, after a 'description not found' line. Nothing is written to the registry, so setup's uninstall has nothing more to clean up, and nothing depends on a message DLL being present or extracted from the single-file build. The server checks the owner of every entry, and the TLS key and password file keep a protected DACL granting the console user, so the folder alone is not enough. |
| 2026-10-12 | (Partly superseded by the console-run data folder recovery row below: `takeown /A /R`, then `icacls /remove:g` of the account the console ran as, never `/reset`.) When the Windows service fails to start or stop, it writes the reason to the Application event log as source `TitanoServer` (advapi32 `ReportEventW`; event 1 start, event 2 stop) as well as to stderr. The reason comes first (the refused entry), then the exception. The source is not registered with a message file. The Windows README says where to look. It also says how to fix a data folder created by an unelevated console run: delete it (with SQLite, the database goes with it), or `takeown /A /R` and `icacls /reset /T` it from an administrator prompt, after which the server makes it private again. | Register the source at `--install-service` with .NET Framework's EventLogMessages.dll; `System.Diagnostics.EventLog`; a log file outside the data folder; re-own only the folder | A service has no console, and the data folder refusal comes before the log file exists (the log folder may itself be the refused entry), so the SCM recorded only error 1064. Event Viewer shows an unregistered source's text whole, after a 'description not found' line. Nothing is written to the registry, so setup's uninstall has nothing more to clean up, and nothing depends on a message DLL being present or extracted from the single-file build. The server checks the owner of every entry, and the TLS key and password file keep a protected DACL granting the console user, so the folder alone is not enough. |
| 2026-10-12 | Deployment guidance (compose comments, releases README, Unraid template) lists the reverse proxy container's own fixed address in `TITANO_TRUSTED_PROXIES`: a fixed IP on a user-defined network shared with Titano, reached on that network rather than through a published port. It warns never to list a subnet, the network gateway or Docker's default bridge. For a proxy on the Docker host itself, Titano runs with `network_mode: host` and the proxy reaches it over loopback. This replaces 'its address or subnet' in the trusted-proxies row above. | Keep recommending the shared network's subnet; make the server refuse gateway addresses | Docker's userland proxy relays IPv6 clients and the host's own connections to published ports from the gateway. On Unraid's default bridge the subnet also covers every other container. Trusting a subnet would let any of them set X-Forwarded-For/Proto again. The server cannot tell a gateway from a proxy, so the guidance has to carry the rule. |
| 2026-10-12 | Sign-in entry move: on an upgrade, setup moves the client's or the Uploader's sign-in entry that starts a program the upgrade removes. The entry then starts the program of the same component in the new payload (its shortcut target), with the same options and value name. The entry is removed only when that component is no longer installed. Uninstall removes the entries of the programs its log lists, as before. | Delete the entry and let the client follow it (impossible: nothing is left to follow); remove the client's follow and drop rename support | Setup runs while the programs are closed and knows both the removed and the new program. So the rename case of the Startup row ('rewritten only when an update renamed the program') survives the upgrade, and Task Manager's on/off state stays with the unchanged value name. The client's own follow remains for an entry setup did not move. |
| 2026-10-12 | Setup removes a sign-in entry's Task Manager state (`StartupApproved\Run` value of the same name) together with the entry; an entry an upgrade moves to a renamed program keeps it. | Leave the value (Windows ignores it without a Run value) | Uninstall leaves nothing of the entry behind, and an entry the user turned off stays off after an upgrade that renames its program. |