mirror of
https://github.com/immich-app/immich.git
synced 2024-12-26 10:50:29 +02:00
288 lines
11 KiB
Markdown
288 lines
11 KiB
Markdown
<p align="center">
|
|
<a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/license-MIT-green.svg?color=3F51B5&style=for-the-badge&label=License&logoColor=000000&labelColor=ececec" alt="License: MIT"></a>
|
|
<a href="https://github.com/alextran1502/immich"><img src="https://img.shields.io/github/stars/alextran1502/immich.svg?style=for-the-badge&logo=github&color=3F51B5&label=Stars&logoColor=000000&labelColor=ececec" alt="Star on Github"></a>
|
|
<a href="https://immichci.little-home.net/viewType.html?buildTypeId=Immich_BuildAndroidAndGetArtifact&guest=1">
|
|
<img src="https://img.shields.io/teamcity/http/immichci.little-home.net/s/Immich_BuildAndroidAndGetArtifact.svg?style=for-the-badge&label=Android&logo=teamcity&logoColor=000000&labelColor=ececec" alt="Android Build"/>
|
|
</a>
|
|
<a href="https://immichci.little-home.net/viewType.html?buildTypeId=Immich_BuildAndPublishIOSToTestFlight&guest=1">
|
|
<img src="https://img.shields.io/teamcity/http/immichci.little-home.net/s/Immich_BuildAndPublishIOSToTestFlight.svg?style=for-the-badge&label=iOS&logo=teamcity&logoColor=000000&labelColor=ececec" alt="iOS Build"/>
|
|
</a>
|
|
<a href="https://actions-badge.atrox.dev/alextran1502/immich/goto?ref=main">
|
|
<img alt="Build Status" src="https://img.shields.io/endpoint.svg?url=https%3A%2F%2Factions-badge.atrox.dev%2Falextran1502%2Fimmich%2Fbadge%3Fref%3Dmain&style=for-the-badge&label=Github Action&logo=github&labelColor=ececec&logoColor=000000" />
|
|
</a>
|
|
<a href="https://discord.gg/D8JsnBEuKb">
|
|
<img src="https://img.shields.io/discord/979116623879368755.svg?label=Immich%20Discord&logo=Discord&style=for-the-badge&logoColor=000000&labelColor=ececec" atl="Immich Discord"/>
|
|
</a>
|
|
<br/>
|
|
<br/>
|
|
<br/>
|
|
<br/>
|
|
|
|
<p align="center">
|
|
<img src="design/feature-panel.png" title="Immich Logo">
|
|
</p>
|
|
</p>
|
|
|
|
# Immich
|
|
|
|
**High performance self-hosted photo and video backup solution.**
|
|
|
|
|
|
|
|
Loading ~4000 images/videos
|
|
|
|
## Screenshots
|
|
|
|
### Mobile
|
|
<p align="left">
|
|
<img src="design/login-screen.png" width="150" title="Login With Custom URL">
|
|
<img src="design/backup-screen.png" width="150" title="Backup Setting Info">
|
|
<img src="design/selective-backup-screen.png" width="150" title="Backup Setting Info">
|
|
<img src="design/home-screen.jpeg" width="150" title="Home Screen">
|
|
<img src="design/search-screen.jpeg" width="150" title="Curated Search Info">
|
|
<img src="design/shared-albums.png" width="150" title="Shared Albums">
|
|
<img src="design/nsc6.png" width="150" title="EXIF Info">
|
|
</p>
|
|
|
|
### Web
|
|
<p align="left">
|
|
<img src="design/web-home.jpeg" width="49%" title="Home Dashboard">
|
|
<img src="design/web-detail.jpeg" width="49%" title="Detail">
|
|
</p>
|
|
|
|
# Note
|
|
|
|
**!! NOT READY FOR PRODUCTION! DO NOT USE TO STORE YOUR ASSETS !!**
|
|
|
|
This project is under heavy development, there will be continuous functions, features and api changes.
|
|
|
|
# Features
|
|
|
|
| | Mobile | Web |
|
|
| - | - | - |
|
|
| Upload and view videos and photos | Yes | Yes
|
|
| Auto backup when the app is opened | Yes | N/A
|
|
| Selective album(s) for backup | Yes | N/A
|
|
| Download photos and videos to local device | Yes | Yes
|
|
| Multi-user support | Yes | Yes
|
|
| Album | Yes | Yes
|
|
| Shared Albums | Yes | Yes
|
|
| Quick navigation with draggable scrollbar | Yes | Yes
|
|
| Support RAW (HEIC, HEIF, DNG, Apple ProRaw) | Yes | Yes
|
|
| Metadata view (EXIF, map) | Yes | Yes
|
|
| Search by metadata, objects and image tags | Yes | No
|
|
| Administrative functions (user management) | N/A | Yes
|
|
|
|
|
|
# System Requirement
|
|
|
|
**OS**: Preferred unix-based operating system (Ubuntu, Debian, MacOS...etc).
|
|
|
|
**RAM**: At least 2GB, preffered 4GB.
|
|
|
|
**Core**: At least 2 cores, preffered 4 cores.
|
|
|
|
# Technology Stack
|
|
|
|
There are several services that compose Immich:
|
|
|
|
1. **NestJs** - Backend of the application
|
|
2. **SvelteKit** - Web frontend of the application
|
|
3. **PostgreSQL** - Main database of the application
|
|
4. **Redis** - For sharing websocket instance between docker instances and background tasks message queue.
|
|
5. **Nginx** - Load balancing and optimized file uploading.
|
|
6. **TensorFlow** - Object Detection (COCO SSD) and Image Classification (ImageNet).
|
|
|
|
# Installing
|
|
|
|
## One-step installation - for evaluating only
|
|
|
|
*Applicable system: Ubuntu, Debian, MacOS*
|
|
|
|
*This installation method is for evaluating Immich before futher customization to meet the users' needs.*
|
|
|
|
In the shell, from the directory of your choice, run the following command:
|
|
|
|
```bash
|
|
curl -o- https://raw.githubusercontent.com/immich-app/immich/main/install.sh | bash
|
|
```
|
|
|
|
This script will download the `docker-compose.yml` file and the `.env` file, then populate the necessary information, and finally run the `docker-compose up` or `docker compose up` (based on your docker's version) command.
|
|
|
|
The web application will be available at `http://<machine-ip-address>:2283`, and the server URL for the mobile app will be `http://<machine-ip-address>:2283/api`.
|
|
|
|
The directory which is used to store the backup file is `./immich-app/immich-data`.
|
|
|
|
|
|
## Customize installation - for production usage
|
|
|
|
### Step 1 - Download necessary files
|
|
|
|
Create a directory called `immich-app` and cd into it. Then
|
|
|
|
Get `docker-compose.yml`
|
|
|
|
```bash
|
|
wget https://raw.githubusercontent.com/immich-app/immich/main/docker/docker-compose.yml
|
|
```
|
|
|
|
Get `.env`
|
|
|
|
```bash
|
|
wget -O .env https://raw.githubusercontent.com/immich-app/immich/main/docker/.env.example
|
|
```
|
|
|
|
### Step 2 - Populate .env file with customed information
|
|
|
|
* Populate customised database information if necessary.
|
|
* Populate `UPLOAD_LOCATION` as prefered location for storing backup assets.
|
|
* Populate a secret value for `JWT_SECRET`
|
|
* [Optional] Populate Mapbox value.
|
|
|
|
**Example**
|
|
|
|
```bash
|
|
###################################################################################
|
|
# Database
|
|
###################################################################################
|
|
DB_USERNAME=postgres
|
|
DB_PASSWORD=postgres
|
|
DB_DATABASE_NAME=immich
|
|
|
|
###################################################################################
|
|
# Upload File Config
|
|
###################################################################################
|
|
UPLOAD_LOCATION=<put-the-path-of-the-upload-folder-here>
|
|
|
|
###################################################################################
|
|
# JWT SECRET
|
|
###################################################################################
|
|
JWT_SECRET=randomstringthatissolongandpowerfulthatnoonecanguess
|
|
|
|
###################################################################################
|
|
# MAPBOX
|
|
####################################################################################
|
|
# ENABLE_MAPBOX is either true of false -> if true, you have to provide MAPBOX_KEY
|
|
ENABLE_MAPBOX=false
|
|
MAPBOX_KEY=
|
|
```
|
|
|
|
### Step 3 - Start the containers
|
|
|
|
Run `docker-compose up` or `docker compose up` (based on your docker's version)
|
|
|
|
### Step 4 - Register admin user
|
|
|
|
Navigate to the web at `http://<machine-ip-address>:2283` and follow the prompts to register admin user.
|
|
|
|
<p align="left">
|
|
<img src="design/admin-registration-form.png" width="300" title="Admin Registration">
|
|
<p/>
|
|
|
|
Additional accounts on the server can be created by the admin account.
|
|
|
|
<p align="left">
|
|
<img src="design/admin-interface.png" width="500" title="Admin User Management">
|
|
<p/>
|
|
|
|
### Step 5 - Access the mobile app
|
|
|
|
Login the mobile app with the server endpoint URL at `http://<machine-ip-address>:2283/api`
|
|
|
|
<p align="left">
|
|
<img src="design/login-screen.jpeg" width="250" title="Example login screen">
|
|
<p/>
|
|
|
|
## Mobile app
|
|
|
|
## F-Droid
|
|
You can get the app on F-droid by clicking the image below.
|
|
|
|
[<img src="https://fdroid.gitlab.io/artwork/badge/get-it-on.png"
|
|
alt="Get it on F-Droid"
|
|
height="80">](https://f-droid.org/packages/app.alextran.immich)
|
|
|
|
|
|
## Android
|
|
|
|
#### Get the app on Google Play Store [here](https://play.google.com/store/apps/details?id=app.alextran.immich)
|
|
|
|
*The App version might be lagging behind the latest release due to the review process.*
|
|
|
|
<p align="left">
|
|
<img src="design/google-play-qr-code.png" width="200" title="Google Play Store">
|
|
<p/>
|
|
|
|
## iOS
|
|
|
|
#### Get the app on Apple AppStore [here](https://apps.apple.com/us/app/immich/id1613945652):
|
|
|
|
*The App version might be lagging behind the latest release due to the review process.*
|
|
|
|
|
|
<p align="left">
|
|
<img src="design/ios-qr-code.png" width="200" title="Apple App Store">
|
|
<p/>
|
|
|
|
|
|
# Development
|
|
|
|
The development environment can be started from the root of the project after populating the `.env` file with the command:
|
|
|
|
```bash
|
|
make dev # required Makefile installed on the system.
|
|
```
|
|
|
|
All servers and web container are hot reload for quick feedback loop.
|
|
|
|
## Note for developers
|
|
### 1 - OpenAPI
|
|
OpenAPI is used to generate the client (Typescript, Dart) SDK. `openapi-generator-cli` can be installed [here](https://openapi-generator.tech/docs/installation/). When you add a new or modify an existing endpoint, you must run the generate command below to update the client SDK.
|
|
|
|
```bash
|
|
npm run api:generate # Run from server directory
|
|
```
|
|
You can find the generated client SDK in the [`web/src/api`](web/src/api) for Typescript SDK and [`mobile/openapi`](mobile/openapi) for Dart SDK.
|
|
|
|
# Support
|
|
|
|
If you like the app, find it helpful, and want to support me to offset the cost of publishing to AppStores, you can sponsor the project with [**one time**](https://github.com/sponsors/alextran1502?frequency=one-time&sponsor=alextran1502) or monthly donation from [**Github Sponsor**](https://github.com/sponsors/alextran1502)
|
|
|
|
You can also donate using crypto currency with the following addresses:
|
|
|
|
<p align="left" style="display: flex; place-items: center; gap: 20px" title="Bitcoin(BTC)">
|
|
<img src="design/bitcoin.png" width="25" title="Bitcoin">
|
|
<code>1FvEp6P6NM8EZEkpGUFAN2LqJ1gxusNxZX</code>
|
|
</p>
|
|
|
|
|
|
<p align="left" style="display: flex; place-items: center; gap: 15px" title="Cardano(ADA)">
|
|
<img src="design/cardano.png" width="30" title="Cardano">
|
|
<code>
|
|
addr1qyy567vqhqrr3p7vpszr5p264gw89sqcwts2z8wqy4yek87cdmy79zazyjp7tmwhkluhk3krvslkzfvg0h43tytp3f5q49nycc
|
|
</code>
|
|
</p>
|
|
|
|
|
|
This is also a meaningful way to give me motivation and encouragement to continue working on the app.
|
|
|
|
Cheers! 🎉
|
|
|
|
# Known Issue
|
|
|
|
## TensorFlow Build Issue
|
|
|
|
*This is a known issue for incorrect Promox setup*
|
|
|
|
TensorFlow doesn't run with older CPU architecture, it requires a CPU with AVX and AVX2 instruction set. If you encounter the error `illegal instruction core dump` when running the docker-compose command above, check for your CPU flags with the command and make sure you see `AVX` and `AVX2`:
|
|
|
|
```bash
|
|
more /proc/cpuinfo | grep flags
|
|
```
|
|
|
|
If you are running virtualization in Promox, the VM doesn't have the flag enabled.
|
|
|
|
You need to change the CPU type from `kvm64` to `host` under VMs hardware tab.
|
|
|
|
`Hardware > Processors > Edit > Advanced > Type (dropdown menu) > host`
|