https://github.com/daemonless/immich-ml
Native FreeBSD OCI container image for Immich Machine Learning
https://github.com/daemonless/immich-ml
freebsd machine-learning oci-image photos podman
Last synced: 4 months ago
JSON representation
Native FreeBSD OCI container image for Immich Machine Learning
- Host: GitHub
- URL: https://github.com/daemonless/immich-ml
- Owner: daemonless
- License: bsd-2-clause
- Created: 2025-12-28T08:32:15.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2026-01-12T12:41:00.000Z (6 months ago)
- Last Synced: 2026-01-12T18:59:28.274Z (6 months ago)
- Topics: freebsd, machine-learning, oci-image, photos, podman
- Language: Dockerfile
- Homepage: https://daemonless.io/images/immich-ml/
- Size: 23.2 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Immich Machine Learning
Immich Machine Learning service (Python/ONNX) on FreeBSD.
| | |
|---|---|
| **Port** | 3003 |
| **Registry** | `ghcr.io/daemonless/immich-ml` |
| **Docs** | [daemonless.io/images/immich-ml](https://daemonless.io/images/immich-ml/) |
| **Source** | [https://github.com/immich-app/immich](https://github.com/immich-app/immich) |
| **Website** | [https://immich.app/](https://immich.app/) |
## Deployment
### Podman Compose
```yaml
services:
immich-ml:
image: ghcr.io/daemonless/immich-ml:latest
container_name: immich-ml
environment:
- MACHINE_LEARNING_HOST=0.0.0.0
- MACHINE_LEARNING_PORT=3003
- MACHINE_LEARNING_CACHE_FOLDER=/cache
- PUID=1000
- PGID=1000
- TZ=UTC
volumes:
- /path/to/containers/immich-ml/cache:/cache
- /path/to/containers/immich-ml:/config
ports:
- 3003:3003
restart: unless-stopped
```
### Podman CLI
```bash
podman run -d --name immich-ml \
-p 3003:3003 \
-e MACHINE_LEARNING_HOST=0.0.0.0 \
-e MACHINE_LEARNING_PORT=3003 \
-e MACHINE_LEARNING_CACHE_FOLDER=/cache \
-e PUID=@PUID@ \
-e PGID=@PGID@ \
-e TZ=@TZ@ \
-v /path/to/containers/immich-ml/cache:/cache \
-v /path/to/containers/immich-ml:/config \
ghcr.io/daemonless/immich-ml:latest
```
Access at: `http://localhost:3003`
### Ansible
```yaml
- name: Deploy immich-ml
containers.podman.podman_container:
name: immich-ml
image: ghcr.io/daemonless/immich-ml:latest
state: started
restart_policy: always
env:
MACHINE_LEARNING_HOST: "0.0.0.0"
MACHINE_LEARNING_PORT: "3003"
MACHINE_LEARNING_CACHE_FOLDER: "/cache"
PUID: "@PUID@"
PGID: "@PGID@"
TZ: "@TZ@"
ports:
- "3003:3003"
volumes:
- "/path/to/containers/immich-ml/cache:/cache"
- "/path/to/containers/immich-ml:/config"
```
## Configuration
### Environment Variables
| Variable | Default | Description |
|----------|---------|-------------|
| `MACHINE_LEARNING_HOST` | `0.0.0.0` | Host to bind to (0.0.0.0) |
| `MACHINE_LEARNING_PORT` | `3003` | Port to bind to (3003) |
| `MACHINE_LEARNING_CACHE_FOLDER` | `/cache` | Path to cache folder (/cache) |
| `PUID` | `1000` | User ID for the application process |
| `PGID` | `1000` | Group ID for the application process |
| `TZ` | `UTC` | Timezone for the container |
### Volumes
| Path | Description |
|------|-------------|
| `/cache` | Model cache directory (HuggingFace) |
| `/config` | Configuration directory (unused but mounted) |
### Ports
| Port | Protocol | Description |
|------|----------|-------------|
| `3003` | TCP | ML API |
This image is part of the [Immich Stack](https://daemonless.io/images/immich).
## Notes
- **Architectures:** amd64
- **User:** `bsd` (UID/GID set via PUID/PGID)
- **Base:** Built on `ghcr.io/daemonless/base` (FreeBSD)