1
0
mirror of https://github.com/immich-app/immich.git synced 2024-12-25 10:43:13 +02:00
Self-hosted photo and video backup solution directly from your mobile phone.
Go to file
Matthias Rupp 19b1fad274
Add message to login screen (useful for demo instances) (#329)
* Add message for demo instances to login screen

* Rename env variable

* Added key into

* Add styling to conform with Immich color scheme

Co-authored-by: Alex Tran <alex.tran1502@gmail.com>
2022-07-10 22:31:17 -05:00
.github fixed release build directory for Github action 2022-06-30 00:10:01 -05:00
design Update readme with additional image 2022-06-24 07:28:56 -05:00
docker Add message to login screen (useful for demo instances) (#329) 2022-07-10 22:31:17 -05:00
fastlane Added required setup for f-droid (#88) 2022-03-29 14:13:47 -05:00
machine-learning Use npm ci for installing pacakages (#304) 2022-07-04 13:47:25 -05:00
mobile Add translation keys for upload info section (#319) 2022-07-07 17:25:02 -05:00
nginx Fixed issue with unexposed Nginx port on release image 2022-06-30 00:26:54 -05:00
server Refactor web to use OpenAPI SDK (#326) 2022-07-10 21:41:45 -05:00
web Add message to login screen (useful for demo instances) (#329) 2022-07-10 22:31:17 -05:00
.gitignore Implemented getting correct disk info for the mounted directory (#72) 2022-03-23 14:53:45 -05:00
LICENSE Update Readme 2022-02-11 22:35:14 -06:00
localizely.yml Change localizely format to json 2022-07-08 15:53:20 +02:00
Makefile Fix typeorm migrations (#297) 2022-07-04 14:20:43 -05:00
NOTES.md Add web interface with admin functionality (#167) 2022-05-21 02:23:55 -05:00
PR_CHECKLIST.md Deploy 1.8.0_12-dev (#132) 2022-04-29 13:10:42 -05:00
README.md Update readme with new discord invitation link 2022-06-29 23:50:24 -05:00

License: MIT Star on Github Android Build iOS Build Build Status



Immich

High performance self-hosted photo and video backup solution.

Loading ~4000 images/videos

Screenshots

Mobile

Web

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 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
Shared Albums Yes No
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) No Yes

System Requirement

OS: Preferred unix-based operating system (Ubuntu, Debian, MacOS...etc).

I haven't tested with Docker for Windows as well as WSL on Windows

Raspberry Pi can be used but microservices container has to be comment out in docker-compose since TensorFlow has not been supported in Docker image on arm64v7 yet.

RAM: At least 2GB, preffered 4GB.

Core: At least 2 cores, preffered 4 cores.

Getting Started

You can use docker compose for development and testing out the application, 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).

Step 1: Populate .env file

Navigate to docker directory and run

cp .env.example .env

Then populate the value in there.

Notice that if set ENABLE_MAPBOX to true, you will have to provide MAPBOX_KEY for the server to run.

Pay attention to the key UPLOAD_LOCATION, this directory must exist and is owned by the user that run the docker-compose command below.

Example

###################################################################################
# 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=

###################################################################################
# WEB
###################################################################################
# This is the URL of your vm/server where you host Immich, so that the web frontend
# know where can it make the request to.
# For example: If your server IP address is 10.1.11.50, the environment variable will
# be VITE_SERVER_ENDPOINT=http://10.1.11.50:2283/api
VITE_SERVER_ENDPOINT=http://192.168.1.216:2283/api

Step 2: Start the server

To start, run

docker-compose -f ./docker/docker-compose.yml up 

If you have a few thousand photos/videos, I suggest running docker-compose with scaling option for the immich_server container to handle high I/O load when using fast scrolling.

docker-compose -f ./docker/docker-compose.yml up --scale immich-server=5 

To update docker-compose with newest image (if you have started the docker-compose previously)

docker-compose -f ./docker/docker-compose.yml pull && docker-compose -f ./docker/docker-compose.yml up

The server will be running at http://your-ip:2283/api through Nginx

Step 3: Register User

Access the web interface at http://your-ip:2283 to register an admin account.

Additional accounts on the server can be created by the admin account.

Step 4: Run mobile app

Login the mobile app with your server address

F-Droid

You can get the app on F-droid by clicking the image below.

Get it on F-Droid

Android

Get the app on Google Play Store here

The App version might be lagging behind the latest release due to the review process.

iOS

Get the app on Apple AppStore here:

The App version might be lagging behind the latest release due to the review process.

Development

The development environment can be started from the root of the project after populating the .env file with the command:

make dev # required Makefile installed on the system.

All servers and web container are hot reload for quick feedback loop.

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 Github Sponsor, or a one time donation with the Buy Me a coffee link below.

"Buy Me A Coffee"

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 on RaspberryPi 4 arm64-v7 and 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:

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

Otherwise you can:

  • edit docker-compose.yml file and comment the whole immich-machine-learning service which will disable machine learning features like object detection and image classification
  • switch to a different VM/desktop with different architecture.