gaschz/trilium
1
0
Fork 0
mirror of https://github.com/zadam/trilium.git synced 2026-01-18 20:44:26 +01:00
Code Issues Actions 12 Packages Projects Releases Wiki Activity

feat(ux): show more helpful output when users encounter permissions issues within the data directory

Browse Source
This commit is contained in:
perfectra1n 2026-01-05 11:38:18 -08:00
parent 51513d3779
commit 142ed42d90
1 changed files with 37 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

38
apps/server/src/services/data_dir.ts
View File

@ -75,9 +75,45 @@ export function getPlatformAppDataDir(platform: ReturnType<typeof os.platform>,
}
}
function outputPermissionDiagnostics(targetPath: fs.PathLike) {
const pathStr = targetPath.toString();
const parentDir = pathJoin(pathStr, "..");
console.error("\n========== PERMISSION ERROR DIAGNOSTICS ==========");
console.error(`Failed to create directory: ${pathStr}`);
// Output current process UID:GID (Unix only)
if (typeof process.getuid === "function" && typeof process.getgid === "function") {
console.error(`Process running as UID:GID = ${process.getuid()}:${process.getgid()}`);
}
// Try to get parent directory stats
try {
const stats = fs.statSync(parentDir);
console.error(`Parent directory: ${parentDir}`);
console.error(` Owner UID:GID = ${stats.uid}:${stats.gid}`);
console.error(` Permissions = ${(stats.mode & 0o777).toString(8)} (octal)`);
} catch {
console.error(`Parent directory ${parentDir} is not accessible`);
}
console.error("\nTo fix this issue:");
console.error(" - Ensure the data directory is owned by the user running Trilium");
console.error(" - Or set USER_UID and USER_GID environment variables to match the directory owner");
console.error(" - Example: docker run -e USER_UID=$(id -u) -e USER_GID=$(id -g) ...");
console.error("====================================================\n");
}
function createDirIfNotExisting(path: fs.PathLike, permissionMode: fs.Mode = FOLDER_PERMISSIONS) {
if (!fs.existsSync(path)) {
fs.mkdirSync(path, permissionMode);
try {
fs.mkdirSync(path, permissionMode);
} catch (err: unknown) {
if (err && typeof err === "object" && "code" in err && err.code === "EACCES") {
outputPermissionDiagnostics(path);
}
throw err;
}
}
}