From 48aac069700b4ea62b7e4bd206ec988ccfe0c16d Mon Sep 17 00:00:00 2001 From: igorpecovnik <6281704+igorpecovnik@users.noreply.github.com> Date: Wed, 30 Apr 2025 16:19:39 +0000 Subject: [PATCH] `Automatic` documentation update --- docs/User-Guide_Armbian-Software/Media.md | 100 +++++++++++++++++++ docs/User-Guide_Armbian-Software/Software.md | 100 +++++++++++++++++++ docs/images/IMM001.png | Bin 0 -> 4615 bytes 3 files changed, 200 insertions(+) create mode 100644 docs/images/IMM001.png diff --git a/docs/User-Guide_Armbian-Software/Media.md b/docs/User-Guide_Armbian-Software/Media.md index d98aad39..bc3df8de 100644 --- a/docs/User-Guide_Armbian-Software/Media.md +++ b/docs/User-Guide_Armbian-Software/Media.md @@ -404,3 +404,103 @@ armbian-config --cmd HPS003 + +## Immich + + +Immich - high-performance self-hosted photo and video backup solution + + + +[![Immich](/images/IMM001.png)](#) + + + + +[**Immich**](https://immich.app/) is a self-hosted photo and video backup solution, designed for individuals and families who want: + +- An alternative to cloud-based services like Google Photos or iCloud +- A private, secure place to store, browse, and share memories +- Powerful features like automatic mobile uploads, facial recognition, and search +- A modern, responsive web and mobile interface for easy access + +Thanks to Immich being built with modern technologies like NestJS, TypeScript, and machine learning integrations, users enjoy a smooth, intelligent media experience. Whether you’re a casual user backing up phone photos or a tech-savvy person managing media across multiple devices, Immich provides the flexibility and control of a cloud solution—on your own server. + +**Summary** + +- **Immich** is ideal if you want full privacy, open-source flexibility, and control over your data. +- **Google Photos** is convenient and polished but comes with trade-offs in privacy and cost at scale. +- **Synology Photos** fits well in homes or small offices already using Synology NAS systems, offering good performance with integrated features. + + + +**Author:** @igorpecovnik + +**Status:** Preview + + +~~~ custombash +armbian-config --cmd IMM001 +~~~ + + + +=== "Access to the service" + + Immich is accessible via HTTP on port **8077**: + + - URL: `http://:8077` + +=== "Default credentials" + + - Email: *(set during initial setup)* + - Password: *(set during initial setup)* + +=== "Directories" + + - Uploads: `/armbian/photos/upload/` + - Thumbnails: `/armbian/photos/thumbs/` + - Profile images: `/armbian/photos/profile/` + - Library: `/armbian/photos/library/` + - Encoded videos: `/armbian/photos/encoded-video/` + - Backups: `/armbian/photos/backups/` + +=== "View logs" + + ```sh + docker logs -f immich_server + ``` + +=== "Immich vs Google Photos vs Synology Photos" + + | Feature / Aspect | **Immich** | **Google Photos** | **Synology Photos** | + |-------------------------------|-------------------------------------------|---------------------------------------------|---------------------------------------------| + | **Hosting** | Self-hosted | Cloud (Google infrastructure) | Self-hosted (on Synology NAS) | + | **Privacy & Control** | Full control, private data storage | Data stored and analyzed by Google | Full control within your NAS environment | + | **Automatic Uploads** | Yes (via mobile app) | Yes (via mobile app) | Yes (via mobile app or Synology Drive) | + | **Facial Recognition** | Yes (on-device) | Yes (cloud-based) | Yes (on-device) | + | **Object & Scene Detection** | Yes (limited but improving) | Yes (advanced AI) | Yes (basic) | + | **Web Interface** | Yes (modern and responsive) | Yes | Yes | + | **Mobile Apps** | Yes (iOS & Android) | Yes (iOS & Android) | Yes (iOS & Android) | + | **Albums & Sharing** | Yes (with public and private sharing) | Yes (advanced sharing options) | Yes | + | **Multi-user Support** | Yes | Limited (mostly single user) | Yes (multi-user, tied to NAS users) | + | **Backup Original Quality** | Yes (no compression) | Only with paid storage | Yes (NAS dependent) | + | **Offline Access** | Limited (depends on app setup) | Yes (with sync) | Yes | + | **Open Source** | Yes | No | No | + | **Hardware Requirement** | Any Docker-capable server or NAS | N/A (runs on Google’s cloud) | Synology NAS required | + | **Price** | Free (self-hosted, you pay for hardware) | Free (with limitations) / Paid for storage | Included with NAS, hardware cost required | + + + + +~~~ bash title="Immich remove:" +armbian-config --cmd IMM002 +~~~ + + +~~~ bash title="Immich purge with data folder:" +armbian-config --cmd IMM003 +~~~ + + + diff --git a/docs/User-Guide_Armbian-Software/Software.md b/docs/User-Guide_Armbian-Software/Software.md index a272007b..56bd4e00 100644 --- a/docs/User-Guide_Armbian-Software/Software.md +++ b/docs/User-Guide_Armbian-Software/Software.md @@ -2173,6 +2173,106 @@ armbian-config --cmd HPS003 +#### Immich + + +Immich - high-performance self-hosted photo and video backup solution + + + +[![Immich](/images/IMM001.png)](#) + + + + +[**Immich**](https://immich.app/) is a self-hosted photo and video backup solution, designed for individuals and families who want: + +- An alternative to cloud-based services like Google Photos or iCloud +- A private, secure place to store, browse, and share memories +- Powerful features like automatic mobile uploads, facial recognition, and search +- A modern, responsive web and mobile interface for easy access + +Thanks to Immich being built with modern technologies like NestJS, TypeScript, and machine learning integrations, users enjoy a smooth, intelligent media experience. Whether you’re a casual user backing up phone photos or a tech-savvy person managing media across multiple devices, Immich provides the flexibility and control of a cloud solution—on your own server. + +**Summary** + +- **Immich** is ideal if you want full privacy, open-source flexibility, and control over your data. +- **Google Photos** is convenient and polished but comes with trade-offs in privacy and cost at scale. +- **Synology Photos** fits well in homes or small offices already using Synology NAS systems, offering good performance with integrated features. + + + +**Author:** @igorpecovnik + +**Status:** Preview + + +~~~ custombash +armbian-config --cmd IMM001 +~~~ + + + +=== "Access to the service" + + Immich is accessible via HTTP on port **8077**: + + - URL: `http://:8077` + +=== "Default credentials" + + - Email: *(set during initial setup)* + - Password: *(set during initial setup)* + +=== "Directories" + + - Uploads: `/armbian/photos/upload/` + - Thumbnails: `/armbian/photos/thumbs/` + - Profile images: `/armbian/photos/profile/` + - Library: `/armbian/photos/library/` + - Encoded videos: `/armbian/photos/encoded-video/` + - Backups: `/armbian/photos/backups/` + +=== "View logs" + + ```sh + docker logs -f immich_server + ``` + +=== "Immich vs Google Photos vs Synology Photos" + + | Feature / Aspect | **Immich** | **Google Photos** | **Synology Photos** | + |-------------------------------|-------------------------------------------|---------------------------------------------|---------------------------------------------| + | **Hosting** | Self-hosted | Cloud (Google infrastructure) | Self-hosted (on Synology NAS) | + | **Privacy & Control** | Full control, private data storage | Data stored and analyzed by Google | Full control within your NAS environment | + | **Automatic Uploads** | Yes (via mobile app) | Yes (via mobile app) | Yes (via mobile app or Synology Drive) | + | **Facial Recognition** | Yes (on-device) | Yes (cloud-based) | Yes (on-device) | + | **Object & Scene Detection** | Yes (limited but improving) | Yes (advanced AI) | Yes (basic) | + | **Web Interface** | Yes (modern and responsive) | Yes | Yes | + | **Mobile Apps** | Yes (iOS & Android) | Yes (iOS & Android) | Yes (iOS & Android) | + | **Albums & Sharing** | Yes (with public and private sharing) | Yes (advanced sharing options) | Yes | + | **Multi-user Support** | Yes | Limited (mostly single user) | Yes (multi-user, tied to NAS users) | + | **Backup Original Quality** | Yes (no compression) | Only with paid storage | Yes (NAS dependent) | + | **Offline Access** | Limited (depends on app setup) | Yes (with sync) | Yes | + | **Open Source** | Yes | No | No | + | **Hardware Requirement** | Any Docker-capable server or NAS | N/A (runs on Google’s cloud) | Synology NAS required | + | **Price** | Free (self-hosted, you pay for hardware) | Free (with limitations) / Paid for storage | Included with NAS, hardware cost required | + + + + +~~~ bash title="Immich remove:" +armbian-config --cmd IMM002 +~~~ + + +~~~ bash title="Immich purge with data folder:" +armbian-config --cmd IMM003 +~~~ + + + + ## Real-time monitoring, collecting metrics, up-time status #### Uptime Kuma diff --git a/docs/images/IMM001.png b/docs/images/IMM001.png new file mode 100644 index 0000000000000000000000000000000000000000..0f86afd31f6bb4e52bd0571aa8931e3625c32d57 GIT binary patch literal 4615 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