96 lines
3.5 KiB
Markdown
96 lines
3.5 KiB
Markdown
# Immich
|
|
|
|
Self-hosted photo and video management server running on box-stableapps (192.168.69.4). Managed by Coolify as a service on the localhost server.
|
|
|
|
## Server Details
|
|
|
|
| | |
|
|
|---|---|
|
|
| Host | 192.168.69.4 (box-stableapps) |
|
|
| Coolify service UUID | `t4cg4wk480w4ck0so0og4wgk` |
|
|
| Coolify project | stable-apps |
|
|
| Image | ghcr.io/immich-app/immich-server:v2 |
|
|
| Web UI port | 2001 (container 2283) |
|
|
| Web UI | https://immich.clintmasden.duckdns.org |
|
|
| SSH | `ssh clint@192.168.69.4` (password: `this-bo%-180391`) |
|
|
|
|
## Containers
|
|
|
|
| Container | Image | Port | Purpose |
|
|
|-----------|-------|------|---------|
|
|
| immich_server | ghcr.io/immich-app/immich-server:v2 | 2001:2283 | Main app server |
|
|
| immich_machine_learning | ghcr.io/immich-app/immich-machine-learning:v2 | internal | Face/object detection |
|
|
| immich_redis | valkey/valkey:9 | internal | Cache |
|
|
| immich_postgres | ghcr.io/immich-app/postgres:14-vectorchord0.4.3-pgvectors0.2.0 | internal | Database with vector extensions |
|
|
|
|
## Volumes
|
|
|
|
| Host Path | Container Path | Type | Notes |
|
|
|-----------|---------------|------|-------|
|
|
| `/home/clint/archive/systems/containers/immich/` | `/data` | CIFS mount | Upload data (photos, thumbs, encoded video) |
|
|
| `/home/clint/archive` | `/archive` | CIFS mount (ro) | Read-only external library browsing |
|
|
| `/home/clint/containers/immich/postgres` | `/var/lib/postgresql/data` | Local ext4 | **MUST be local disk, NOT SMB** (owned uid 999) |
|
|
| `/home/clint/containers/immich/cache` | `/cache` | Local ext4 | ML model cache |
|
|
| `/etc/localtime` | `/etc/localtime` | Bind (ro) | Timezone |
|
|
|
|
## Credentials
|
|
|
|
| What | Value |
|
|
|------|-------|
|
|
| DB_USERNAME | `postgres` |
|
|
| DB_PASSWORD | `Xb1Y4MPIbVZdlK` |
|
|
| DB_DATABASE_NAME | `immich` |
|
|
| IMMICH_VERSION | `v2` |
|
|
|
|
## CIFS Mount Dependency
|
|
|
|
Upload data and archive browsing require the CIFS mount:
|
|
|
|
```
|
|
# /etc/fstab entry
|
|
//192.168.69.2/archive /home/clint/archive cifs rw,credentials=/etc/samba_credentials,iocharset=utf8,vers=3.0,uid=1000,gid=1000,dir_mode=0775,file_mode=0775,_netdev 0 0
|
|
```
|
|
|
|
## Important Notes
|
|
|
|
- Postgres data directory is owned by uid 999 (postgres container user). Do NOT chown.
|
|
- Postgres requires `shm_size: 128mb` for vector operations.
|
|
- Postgres image is a custom build with vectorchord + pgvectors extensions — not standard postgres.
|
|
- Healthchecks must use `127.0.0.1` not `localhost` (Alpine IPv6 resolves localhost to ::1).
|
|
- Upload data on CIFS contains: `backups/`, `encoded-video/`, `library/`, `profile/`, `thumbs/`, `upload/`.
|
|
|
|
## Deployment
|
|
|
|
Managed by Coolify. Start/stop via Coolify UI or API:
|
|
|
|
```bash
|
|
# Start
|
|
curl -X POST http://192.168.69.4:2010/api/v1/services/t4cg4wk480w4ck0so0og4wgk/start \
|
|
-H "Authorization: Bearer <token>"
|
|
|
|
# Stop
|
|
curl -X POST http://192.168.69.4:2010/api/v1/services/t4cg4wk480w4ck0so0og4wgk/stop \
|
|
-H "Authorization: Bearer <token>"
|
|
```
|
|
|
|
## Disaster Recovery
|
|
|
|
If Coolify is lost but data survives:
|
|
|
|
```bash
|
|
cd /home/clint/containers/immich
|
|
sudo docker compose up -d
|
|
```
|
|
|
|
This standalone compose + .env will start Immich with the same config. Traefik routing would need to be re-added.
|
|
|
|
## Backup Locations
|
|
|
|
| Data | Location |
|
|
|------|----------|
|
|
| Config backup | `/home/clint/containers/immich.backup/` |
|
|
| Original compose | `/home/clint/containers/immich.backup/docker-compose.yml.original` |
|
|
| Original .env | `/home/clint/containers/immich.backup/.env.original` |
|
|
| Postgres data | Local disk at `/home/clint/containers/immich/postgres` |
|
|
| Photo data | On NAS at `//192.168.69.2/archive` |
|