From 00eb440c01eaeaaa989a1d97b07bae6331a4ec74 Mon Sep 17 00:00:00 2001 From: Manav Rathi Date: Tue, 20 Aug 2024 11:26:10 +0530 Subject: [PATCH] [doc] Large upload troubleshooting --- docs/docs/.vitepress/sidebar.ts | 4 +++ .../photos/troubleshooting/large-uploads.md | 28 +++++++++++++++++++ 2 files changed, 32 insertions(+) create mode 100644 docs/docs/photos/troubleshooting/large-uploads.md diff --git a/docs/docs/.vitepress/sidebar.ts b/docs/docs/.vitepress/sidebar.ts index 06286ff0343..7a475250a2a 100644 --- a/docs/docs/.vitepress/sidebar.ts +++ b/docs/docs/.vitepress/sidebar.ts @@ -143,6 +143,10 @@ export const sidebar = [ text: "Missing thumbnails", link: "/photos/troubleshooting/thumbnails", }, + { + text: "Large uploads", + link: "/photos/troubleshooting/large-uploads", + }, { text: "Network drives", link: "/photos/troubleshooting/nas", diff --git a/docs/docs/photos/troubleshooting/large-uploads.md b/docs/docs/photos/troubleshooting/large-uploads.md new file mode 100644 index 00000000000..656e9595e23 --- /dev/null +++ b/docs/docs/photos/troubleshooting/large-uploads.md @@ -0,0 +1,28 @@ +--- +title: Large uploads +description: Ente Photos and large (multi TB) uploads +--- + +# Large uploads + +Some customers have reported an issue where their desktop app seems to get stuck +when they are trying to do the initial upload of multi-TB libraries. + +A telltale sign of this is that app would seem to freeze during the upload, and +then restart again from the same state. If you were to look in the logs, you +would notice messages around the "renderer process crashing". + +When this happens, you'll notice in the logs that it crashes when trying to +upload some specific large video, or a set of specific large videos. + +As a workaround, you can **put these videos in a separate folder, complete the +rest of your upload, and then later upload this folder**. + +Another alternative is to drag and drop the folder you are trying to upload into +the app instead of adding a folder watch or uploading a zip. This works better +because during a drag and drop, the app has direct access to the files via +browser APIs instead of going via the file system. + +Note that the app will detect and skip over already uploaded items into an +album, so dragging and dropping the same folder again to upload to the same +album is fine.