# Immich
Immich is a high-performance, self-hosted photo and video management solution. It's an open-source alternative to [[Google Photos]] that runs entirely on your own infrastructure — no cloud dependency for core functionality. Licensed under AGPL-3.0.
## Key features
### Media management
- Upload, view, and organize photos and videos
- Raw format support
- LivePhoto and MotionPhoto backup and playback
- 360-degree image display
- Stacked photos
- Virtual scrolling for large libraries
- Folder view navigation
### Machine learning (local)
- Facial recognition and clustering
- CLIP-based search (search by objects, scenes, text)
- "Memories" feature (anniversary/historical recall)
- All ML runs locally — no external services needed
### Search
- Search by metadata, objects, faces, and CLIP
- Map integration for location-based browsing
- Tags system (web)
- EXIF data viewing
### Backup
- Automatic backup on app launch
- Selective album backup
- Background backup
- Duplication prevention
### Sharing & multi-user
- Multi-user support with admin controls
- Albums and shared albums
- Partner sharing
- Public sharing with customizable links
- Read-only gallery access
## Tech stack
- **Backend**: NestJS / [[Node.js]]
- **Frontend**: Svelte / SvelteKit
- **Mobile**: Flutter / Dart (iOS and Android)
- **Machine Learning**: Python (facial recognition, CLIP)
- **Database**: [[PostgreSQL]]
## Platform support
- **Web**: full-featured interface with admin controls
- **iOS / Android**: near-feature parity with web (minus admin), offline support, background backup
- **CLI**: automation and bulk operations
## API & integration
- RESTful API with OpenAPI specification
- OAuth support
- API keys for programmatic access
## Installation
Primarily deployed via [[Docker]]. Also supports traditional installation and DevContainer for development.
```sh
# Quick start with Docker Compose
docker compose up -d
```
## References
- Source code: https://github.com/immich-app/immich
- Documentation: https://immich.app/docs
- Demo: https://demo.immich.app
## Related
- [[Google Photos]]
- [[Self-hosting]]
- [[Docker]]