* Added reserve geocoding, location in search suggestion, and search by location * Added mapbox sdk to app * Added mapbox to image detailed view
3.4 KiB
IMMICH
Self-hosted photo and video backup solution directly from your mobile phone.
Loading ~4000 images/videos
Screenshots
Note
!! NOT READY FOR PRODUCTION! DO NOT USE TO STORE YOUR ASSETS !!
This project is under heavy development, there will be continous functions, features and api changes.
Features
- Upload assets(videos/images).
- View assets.
- Quick navigation with drag scroll bar.
- Auto Backup.
- Support HEIC/HEIF Backup.
- Extract and display EXIF info.
- Real-time render from multi-device upload event.
- Image Tagging/Classification based on ImageNet dataset
- Search assets based on tags and exif data (lens, make, model, orientation)
- Upload assets from your local computer/server using immich cli tools
- Geocoding to show asset's location information on map (required MapBox registration for their generous free tier)
Development
You can use docker compose for development, there are several services that compose Immich
- NestJs
- PostgreSQL
- Redis
- Nginx
- TensorFlow and Keras
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.
To start, run
docker-compose -f ./docker/docker-compose.yml up --build -V
The server will be running at http://your-ip:2283
through Nginx
Register User
Use the command below on your terminal to create user as we don't have user interface for this function yet.
curl --location --request POST 'http://your-server-ip:2283/auth/signUp' \
--header 'Content-Type: application/json' \
--data-raw '{
"email": "testuser@email.com",
"password": "password"
}'
Run mobile app
Android
Download apk
in release tab and run on your phone. You can follow this guide on how to do that
iOS
- Get a MacOS
- Download and setup Flutter development environment
- Navigate to
mobile
folder - Run with release build command for best performance.
flutter run --release
Known Issue
TensorFlow doesn't run with older CPU architecture, it requires 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
. Otherwise, switch to a different VM/desktop with different architecture.
more /proc/cpuinfo | grep flags
If you are running virtualization in Promox, the VM doesn't have the flag enable.
You need to change the CPU type from kvm64
to host
under VMs hardware tab.
Hardware > Processors > Edit > Advanced > Type (dropdown menu) > host