Implement external storage

Adds an external storage watcher to files API that listens for DBus
events and auto-mounts and -unmounts partitions on external storage
devices at the virtual path `/External/label`. Adds routes to query external
storage devices and to safely eject a disk.

Co-authored-by: Luke Childs <[email protected]>
Co-authored-by: Mayank Chhabra <[email protected]>

Author: 3 people

packages/os/umbrelos.Dockerfile

@@ -120,8 +120,16 @@ RUN apt-get install --yes sudo nano vim less man iproute2 iputils-ping curl wget
 # Install umbreld dependencies
 # (many of these can be remove after the apps refactor)
 RUN apt-get install --yes python3 fswatch jq rsync git gettext-base gnupg procps dmidecode samba wsdd2 p7zip-full imagemagick ffmpeg
+
+# Support for alternate filesystems
+RUN apt-get install --yes ntfs-3g
+
+# TODO: udisks2 recommends eject (2.38.1-5+deb12u3) which is currently missing
+RUN apt-get install --yes --no-install-recommends udisks2
+
 # Disable automatically starting smbd at boot so umbreld can initialize it first
 RUN systemctl disable smbd.service
+
 # Install Node.js
 RUN apt-get install --yes python3 fswatch jq rsync git gettext-base gnupg procps dmidecode
 RUN NODE_ARCH=$([ "${TARGETARCH}" = "arm64" ] && echo "arm64" || echo "x64") && \

packages/ui/public/locales/de.json

@@ -199,6 +199,7 @@
   "files-action.download": "Herunterladen",
   "files-action.download-items": "Lade {{count}} Elemente herunter",
   "files-action.drop-to-upload": "Ablegen zum Hochladen",
+  "files-action.eject-disk": "Datenträger auswerfen",
   "files-action.empty-trash": "Papierkorb leeren",
   "files-action.go-to-path": "Gehe zu...",
   "files-action.new-folder": "Neuer Ordner",
@@ -230,6 +231,7 @@
   "files-error.copy": "Fehler beim Kopieren: {{message}}",
   "files-error.create-folder": "Fehler beim Erstellen des Ordners: {{message}}",
   "files-error.delete": "Fehler beim Löschen: {{message}}",
+  "files-error.eject-disk": "Fehler beim Auswerfen des Datenträgers: {{message}}",
   "files-error.empty-trash": "Fehler beim Leeren des Papierkorbs: {{message}}",
   "files-error.extract": "Fehler beim Extrahieren: {{message}}",
   "files-error.move": "Fehler beim Verschieben: {{message}}",
@@ -243,6 +245,8 @@
   "files-extension-change.description-remove": "Bist du sicher, dass du die Dateiendung von „{{fileName}}“ entfernen möchtest?",
   "files-extension-change.title-add": "Dateiendung in „{{extension}}“ ändern?",
   "files-extension-change.title-remove": "Dateiendung entfernen?",
+  "files-external-storage.unsupported.description": "Dein angeschlossenes externes Laufwerk kann mit diesem Gerät nicht verwendet werden. Die Funktion für externen Speicher ist ausschließlich auf dem Umbrel Home verfügbar.",
+  "files-external-storage.unsupported.title": "Externer Speicher wird nicht unterstützt",
   "files-folder": "Ordner",
   "files-listing.empty": "Keine Elemente",
   "files-listing.error": "Es ist ein Fehler aufgetreten",
@@ -301,6 +305,7 @@
   "files-share.regular-title": "Ordner im Netzwerk freigeben",
   "files-share.toggle": "„{{name}}“ in deinem Netzwerk freigeben",
   "files-sidebar.apps": "Apps",
+  "files-sidebar.external-storage": "Externer Speicher",
   "files-sidebar.favorites": "Favoriten",
   "files-sidebar.home": "Startseite",
   "files-sidebar.navigation": "Dateinavigation",
@@ -336,6 +341,7 @@
   "files-type.excel": "Excel-Tabelle",
   "files-type.exe": "Windows-Ausführbare Datei",
   "files-type.executable": "Ausführbare Datei",
+  "files-type.external-drive": "Laufwerk",
   "files-type.flac": "FLAC-Audio",
   "files-type.flv": "FLV-Video",
   "files-type.gif": "GIF-Bild",

packages/ui/public/locales/en.json

@@ -199,6 +199,7 @@
   "files-action.download": "Download",
   "files-action.download-items": "Download {{count}} items",
   "files-action.drop-to-upload": "Drop to upload",
+  "files-action.eject-disk": "Eject disk",
   "files-action.empty-trash": "Empty Trash",
   "files-action.go-to-path": "Go to...",
   "files-action.new-folder": "New Folder",
@@ -230,6 +231,7 @@
   "files-error.copy": "Error copying: {{message}}",
   "files-error.create-folder": "Error creating folder: {{message}}",
   "files-error.delete": "Error deleting: {{message}}",
+  "files-error.eject-disk": "Error ejecting disk: {{message}}",
   "files-error.empty-trash": "Error emptying trash: {{message}}",
   "files-error.extract": "Error extracting: {{message}}",
   "files-error.move": "Error moving: {{message}}",
@@ -243,6 +245,8 @@
   "files-extension-change.description-remove": "Are you sure you want to remove the extension of '{{fileName}}'?",
   "files-extension-change.title-add": "Change extension to '{{extension}}'?",
   "files-extension-change.title-remove": "Remove extension?",
+  "files-external-storage.unsupported.description": "Your connected external drive cannot be used with this device. External storage functionality is exclusively available on the Umbrel Home.",
+  "files-external-storage.unsupported.title": "External Storage Not Supported",
   "files-folder": "Folder",
   "files-listing.empty": "No items",
   "files-listing.error": "An error occurred",
@@ -301,6 +305,7 @@
   "files-share.regular-title": "Share folder over network",
   "files-share.toggle": "Share \"{{name}}\" over your network",
   "files-sidebar.apps": "Apps",
+  "files-sidebar.external-storage": "External storage",
   "files-sidebar.favorites": "Favorites",
   "files-sidebar.home": "Home",
   "files-sidebar.navigation": "File navigation",
@@ -336,6 +341,7 @@
   "files-type.excel": "Excel Spreadsheet",
   "files-type.exe": "Windows Executable",
   "files-type.executable": "Executable",
+  "files-type.external-drive": "Drive",
   "files-type.flac": "FLAC Audio",
   "files-type.flv": "FLV Video",
   "files-type.gif": "GIF Image",

packages/ui/public/locales/es.json

@@ -199,6 +199,7 @@
   "files-action.download": "Descargar",
   "files-action.download-items": "Descargar {{count}} elementos",
   "files-action.drop-to-upload": "Suelta para subir",
+  "files-action.eject-disk": "Expulsar disco",
   "files-action.empty-trash": "Vaciar papelera",
   "files-action.go-to-path": "Ir a...",
   "files-action.new-folder": "Nueva carpeta",
@@ -230,6 +231,7 @@
   "files-error.copy": "Error al copiar: {{message}}",
   "files-error.create-folder": "Error al crear carpeta: {{message}}",
   "files-error.delete": "Error al eliminar: {{message}}",
+  "files-error.eject-disk": "Error al expulsar el disco: {{message}}",
   "files-error.empty-trash": "Error al vaciar la papelera: {{message}}",
   "files-error.extract": "Error al extraer: {{message}}",
   "files-error.move": "Error al mover: {{message}}",
@@ -243,6 +245,8 @@
   "files-extension-change.description-remove": "¿Estás seguro de que quieres quitar la extensión de '{{fileName}}'?",
   "files-extension-change.title-add": "¿Cambiar la extensión a '{{extension}}'?",
   "files-extension-change.title-remove": "¿Quitar la extensión?",
+  "files-external-storage.unsupported.description": "La unidad de almacenamiento externo que conectaste no se puede usar con este dispositivo. La funcionalidad de almacenamiento externo está disponible exclusivamente en Umbrel Home.",
+  "files-external-storage.unsupported.title": "Almacenamiento externo no compatible",
   "files-folder": "Carpeta",
   "files-listing.empty": "No hay elementos",
   "files-listing.error": "Ocurrió un error",
@@ -301,6 +305,7 @@
   "files-share.regular-title": "Compartir carpeta en la red",
   "files-share.toggle": "Compartir \"{{name}}\" en tu red",
   "files-sidebar.apps": "Aplicaciones",
+  "files-sidebar.external-storage": "Almacenamiento externo",
   "files-sidebar.favorites": "Favoritos",
   "files-sidebar.home": "Inicio",
   "files-sidebar.navigation": "Navegación de archivos",
@@ -336,6 +341,7 @@
   "files-type.excel": "Hoja de cálculo de Excel",
   "files-type.exe": "Ejecutable de Windows",
   "files-type.executable": "Ejecutable",
+  "files-type.external-drive": "Unidad",
   "files-type.flac": "Audio FLAC",
   "files-type.flv": "Vídeo FLV",
   "files-type.gif": "Imagen GIF",

packages/ui/public/locales/fr.json

@@ -199,6 +199,7 @@
   "files-action.download": "Télécharger",
   "files-action.download-items": "Télécharger {{count}} éléments",
   "files-action.drop-to-upload": "Déposez pour importer",
+  "files-action.eject-disk": "Éjecter le disque",
   "files-action.empty-trash": "Vider la corbeille",
   "files-action.go-to-path": "Aller à...",
   "files-action.new-folder": "Nouveau dossier",
@@ -230,6 +231,7 @@
   "files-error.copy": "Erreur lors de la copie : {{message}}",
   "files-error.create-folder": "Erreur lors de la création du dossier : {{message}}",
   "files-error.delete": "Erreur lors de la suppression : {{message}}",
+  "files-error.eject-disk": "Erreur lors de l'éjection du disque : {{message}}",
   "files-error.empty-trash": "Erreur lors du vidage de la corbeille : {{message}}",
   "files-error.extract": "Erreur lors de l’extraction : {{message}}",
   "files-error.move": "Erreur lors du déplacement : {{message}}",
@@ -243,6 +245,8 @@
   "files-extension-change.description-remove": "Êtes-vous sûr de vouloir supprimer l’extension de « {{fileName}} » ?",
   "files-extension-change.title-add": "Changer l’extension en « {{extension}} » ?",
   "files-extension-change.title-remove": "Supprimer l’extension ?",
+  "files-external-storage.unsupported.description": "Votre disque externe connecté ne peut pas être utilisé avec cet appareil. La fonctionnalité de stockage externe est exclusivement disponible sur Umbrel Home.",
+  "files-external-storage.unsupported.title": "Stockage externe non pris en charge",
   "files-folder": "Dossier",
   "files-listing.empty": "Aucun élément",
   "files-listing.error": "Une erreur s'est produite",
@@ -301,6 +305,7 @@
   "files-share.regular-title": "Partager ce dossier sur le réseau",
   "files-share.toggle": "Partager « {{name}} » sur votre réseau",
   "files-sidebar.apps": "Applications",
+  "files-sidebar.external-storage": "Stockage externe",
   "files-sidebar.favorites": "Favoris",
   "files-sidebar.home": "Accueil",
   "files-sidebar.navigation": "Navigation des fichiers",
@@ -336,6 +341,7 @@
   "files-type.excel": "Feuille de calcul Excel",
   "files-type.exe": "Exécutable Windows",
   "files-type.executable": "Exécutable",
+  "files-type.external-drive": "Disque",
   "files-type.flac": "Audio FLAC",
   "files-type.flv": "Vidéo FLV",
   "files-type.gif": "Image GIF",

packages/ui/public/locales/hu.json

@@ -199,6 +199,7 @@
   "files-action.download": "Letöltés",
   "files-action.download-items": "{{count}} elem letöltése",
   "files-action.drop-to-upload": "Húzd ide a feltöltéshez",
+  "files-action.eject-disk": "Lemez kiadása",
   "files-action.empty-trash": "Kuka ürítése",
   "files-action.go-to-path": "Ugrás ide...",
   "files-action.new-folder": "Új mappa",
@@ -230,6 +231,7 @@
   "files-error.copy": "Hiba a másolás során: {{message}}",
   "files-error.create-folder": "Hiba a mappa létrehozása során: {{message}}",
   "files-error.delete": "Hiba a törlés során: {{message}}",
+  "files-error.eject-disk": "Hiba a lemez kiadásakor: {{message}}",
   "files-error.empty-trash": "Hiba a kuka ürítése során: {{message}}",
   "files-error.extract": "Hiba a kicsomagolás során: {{message}}",
   "files-error.move": "Hiba az áthelyezés során: {{message}}",
@@ -243,6 +245,8 @@
   "files-extension-change.description-remove": "Biztosan szeretnéd eltávolítani a(z) „{{fileName}}” fájlkiterjesztését?",
   "files-extension-change.title-add": "Kiterjesztés módosítása „{{extension}}”-re?",
   "files-extension-change.title-remove": "Kiterjesztés eltávolítása?",
+  "files-external-storage.unsupported.description": "A csatlakoztatott külső meghajtó nem használható ezen az eszközön. A külső tárhely funkció kizárólag az Umbrel Home-on érhető el.",
+  "files-external-storage.unsupported.title": "Külső tárhely nem támogatott",
   "files-folder": "Mappa",
   "files-listing.empty": "Nincsenek elemek",
   "files-listing.error": "Hiba történt",
@@ -301,6 +305,7 @@
   "files-share.regular-title": "Mappa megosztása a hálózaton",
   "files-share.toggle": "„{{name}}” megosztása a hálózatodon",
   "files-sidebar.apps": "Alkalmazások",
+  "files-sidebar.external-storage": "Külső tárhely",
   "files-sidebar.favorites": "Kedvencek",
   "files-sidebar.home": "Saját mappa",
   "files-sidebar.navigation": "Fájlböngészés",
@@ -336,6 +341,7 @@
   "files-type.excel": "Excel táblázat",
   "files-type.exe": "Windows futtatható fájl",
   "files-type.executable": "Futtatható fájl",
+  "files-type.external-drive": "Meghajtó",
   "files-type.flac": "FLAC hang",
   "files-type.flv": "FLV videó",
   "files-type.gif": "GIF kép",

packages/ui/public/locales/it.json

@@ -199,6 +199,7 @@
   "files-action.download": "Scarica",
   "files-action.download-items": "Scarica {{count}} elementi",
   "files-action.drop-to-upload": "Rilascia per caricare",
+  "files-action.eject-disk": "Espelli disco",
   "files-action.empty-trash": "Svuota il Cestino",
   "files-action.go-to-path": "Vai a...",
   "files-action.new-folder": "Nuova cartella",
@@ -230,6 +231,7 @@
   "files-error.copy": "Errore durante la copia: {{message}}",
   "files-error.create-folder": "Errore durante la creazione della cartella: {{message}}",
   "files-error.delete": "Errore durante l'eliminazione: {{message}}",
+  "files-error.eject-disk": "Errore durante l'espulsione del disco: {{message}}",
   "files-error.empty-trash": "Errore durante lo svuotamento del Cestino: {{message}}",
   "files-error.extract": "Errore durante l'estrazione: {{message}}",
   "files-error.move": "Errore durante lo spostamento: {{message}}",
@@ -243,6 +245,8 @@
   "files-extension-change.description-remove": "Sei sicuro di voler rimuovere l'estensione di '{{fileName}}'?",
   "files-extension-change.title-add": "Cambiare l'estensione in '{{extension}}'?",
   "files-extension-change.title-remove": "Rimuovere l'estensione?",
+  "files-external-storage.unsupported.description": "Il tuo disco esterno collegato non può essere usato con questo dispositivo. La funzionalità di archiviazione esterna è disponibile esclusivamente su Umbrel Home.",
+  "files-external-storage.unsupported.title": "Archiviazione esterna non supportata",
   "files-folder": "Cartella",
   "files-listing.empty": "Nessun elemento",
   "files-listing.error": "Si è verificato un errore",
@@ -301,6 +305,7 @@
   "files-share.regular-title": "Condividi cartella sulla rete",
   "files-share.toggle": "Condividi \"{{name}}\" sulla tua rete",
   "files-sidebar.apps": "App",
+  "files-sidebar.external-storage": "Archiviazione esterna",
   "files-sidebar.favorites": "Preferiti",
   "files-sidebar.home": "Home",
   "files-sidebar.navigation": "Navigazione file",
@@ -336,6 +341,7 @@
   "files-type.excel": "Foglio di calcolo Excel",
   "files-type.exe": "Eseguibile Windows",
   "files-type.executable": "Eseguibile",
+  "files-type.external-drive": "Disco",
   "files-type.flac": "Audio FLAC",
   "files-type.flv": "Video FLV",
   "files-type.gif": "Immagine GIF",

packages/ui/public/locales/ja.json

@@ -199,6 +199,7 @@
   "files-action.download": "ダウンロード",
   "files-action.download-items": "アイテム{{count}}件をダウンロード",
   "files-action.drop-to-upload": "ここにドロップしてアップロード",
+  "files-action.eject-disk": "ディスクを取り出す",
   "files-action.empty-trash": "ゴミ箱を空にする",
   "files-action.go-to-path": "移動...",
   "files-action.new-folder": "新規フォルダ",
@@ -230,6 +231,7 @@
   "files-error.copy": "コピーできませんでした: {{message}}",
   "files-error.create-folder": "フォルダを作成できませんでした: {{message}}",
   "files-error.delete": "削除できませんでした: {{message}}",
+  "files-error.eject-disk": "ディスクを取り出せませんでした: {{message}}",
   "files-error.empty-trash": "ゴミ箱を空にできませんでした: {{message}}",
   "files-error.extract": "解凍できませんでした: {{message}}",
   "files-error.move": "移動できませんでした: {{message}}",
@@ -243,6 +245,8 @@
   "files-extension-change.description-remove": "「{{fileName}}」の拡張子を削除してもよろしいですか？",
   "files-extension-change.title-add": "拡張子を「{{extension}}」に変更しますか？",
   "files-extension-change.title-remove": "拡張子を削除しますか？",
+  "files-external-storage.unsupported.description": "接続された外付けドライブはこのデバイスでは使えません。外部ストレージ機能はUmbrel Homeのみで利用できます。",
+  "files-external-storage.unsupported.title": "外部ストレージには対応していません",
   "files-folder": "フォルダ",
   "files-listing.empty": "アイテムがありません",
   "files-listing.error": "エラーが発生しました",
@@ -301,6 +305,7 @@
   "files-share.regular-title": "ネットワーク経由でフォルダを共有",
   "files-share.toggle": "「{{name}}」をネットワーク共有する",
   "files-sidebar.apps": "アプリ",
+  "files-sidebar.external-storage": "外部ストレージ",
   "files-sidebar.favorites": "お気に入り",
   "files-sidebar.home": "ホーム",
   "files-sidebar.navigation": "ファイルナビゲーション",
@@ -336,6 +341,7 @@
   "files-type.excel": "Excelスプレッドシート",
   "files-type.exe": "Windows実行ファイル",
   "files-type.executable": "実行ファイル",
+  "files-type.external-drive": "ドライブ",
   "files-type.flac": "FLACオーディオ",
   "files-type.flv": "FLVビデオ",
   "files-type.gif": "GIF画像",

packages/ui/public/locales/ko.json

@@ -199,6 +199,7 @@
   "files-action.download": "다운로드",
   "files-action.download-items": "항목 {{count}}개 다운로드",
   "files-action.drop-to-upload": "업로드하려면 여기로 끌어다 놓으세요",
+  "files-action.eject-disk": "디스크 꺼내기",
   "files-action.empty-trash": "휴지통 비우기",
   "files-action.go-to-path": "이동...",
   "files-action.new-folder": "새 폴더",
@@ -230,6 +231,7 @@
   "files-error.copy": "복사 중 오류 발생: {{message}}",
   "files-error.create-folder": "폴더 생성 중 오류 발생: {{message}}",
   "files-error.delete": "삭제 중 오류 발생: {{message}}",
+  "files-error.eject-disk": "디스크를 꺼내는 중 오류가 발생했어요: {{message}}",
   "files-error.empty-trash": "휴지통 비우기 중 오류 발생: {{message}}",
   "files-error.extract": "추출 중 오류 발생: {{message}}",
   "files-error.move": "이동 중 오류 발생: {{message}}",
@@ -243,6 +245,8 @@
   "files-extension-change.description-remove": "정말 '{{fileName}}'의 확장자를 제거하시겠어요?",
   "files-extension-change.title-add": "확장자를 '{{extension}}'(으)로 바꾸기?",
   "files-extension-change.title-remove": "확장자 제거하기?",
+  "files-external-storage.unsupported.description": "연결된 외장 드라이브는 이 기기에서 사용할 수 없어요. 외장 스토리지 기능은 Umbrel Home에서만 이용할 수 있어요",
+  "files-external-storage.unsupported.title": "외장 스토리지를 지원하지 않아요",
   "files-folder": "폴더",
   "files-listing.empty": "항목이 없습니다",
   "files-listing.error": "오류가 발생했어요",
@@ -301,6 +305,7 @@
   "files-share.regular-title": "폴더를 네트워크로 공유하기",
   "files-share.toggle": "네트워크에서 \"{{name}}\"(을)를 공유하기",
   "files-sidebar.apps": "앱",
+  "files-sidebar.external-storage": "외장 스토리지",
   "files-sidebar.favorites": "즐겨찾기",
   "files-sidebar.home": "홈",
   "files-sidebar.navigation": "파일 탐색",
@@ -336,6 +341,7 @@
   "files-type.excel": "Excel 스프레드시트",
   "files-type.exe": "Windows 실행 파일",
   "files-type.executable": "실행 파일",
+  "files-type.external-drive": "드라이브",
   "files-type.flac": "FLAC 오디오",
   "files-type.flv": "FLV 비디오",
   "files-type.gif": "GIF 이미지",