https://github.com/daemonless/emby
Personal media server with apps on just about every device.
https://github.com/daemonless/emby
container emby freebsd media-server podman
Last synced: 12 days ago
JSON representation
Personal media server with apps on just about every device.
- Host: GitHub
- URL: https://github.com/daemonless/emby
- Owner: daemonless
- Created: 2026-05-21T14:17:19.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-06-15T08:48:27.000Z (13 days ago)
- Last Synced: 2026-06-15T11:34:55.054Z (13 days ago)
- Topics: container, emby, freebsd, media-server, podman
- Language: Jinja
- Size: 85 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Emby
[](https://github.com/daemonless/emby/actions)
[](https://github.com/daemonless/emby/commits)
[](https://daemonless.io/guides/ocijail-patch/)
Personal media server with apps on just about every device.
| | |
|---|---|
| **Port** | 8096 |
| **Registry** | `ghcr.io/daemonless/emby` |
| **Source** | [https://github.com/MediaBrowser/Emby](https://github.com/MediaBrowser/Emby) |
| **Website** | [https://emby.media/](https://emby.media/) |
## Version Tags
| Tag | Description | Best For |
| :--- | :--- | :--- |
| `latest` / `pkg` | **FreeBSD Quarterly**. Uses stable, tested packages. | Production stability. |
| `pkg-latest` | **FreeBSD Latest**. Rolling package updates. | Newest FreeBSD packages. |
| `beta` | **Upstream Binary**. Built from official release. | Alternative build. |
## Prerequisites
Before deploying, ensure your host environment is ready. See the [Quick Start Guide](https://daemonless.io/guides/quick-start) for host setup instructions.
## Deployment
### Podman Compose
```yaml
services:
emby:
image: ghcr.io/daemonless/emby:latest
container_name: emby
environment:
- PUID=1000
- PGID=1000
- TZ=UTC
volumes:
- "/path/to/containers/emby:/config"
ports:
- 8096:8096
annotations:
org.freebsd.jail.allow.mlock: "true"
restart: unless-stopped
```
### AppJail Director
**.env**:
```
DIRECTOR_PROJECT=emby
PUID=1000
PGID=1000
TZ=UTC
```
**appjail-director.yml**:
```yaml
options:
- virtualnet: ': default'
- nat:
services:
emby:
name: emby
options:
- container: 'boot args:--pull'
oci:
user: root
environment:
- PUID: !ENV '${PUID}'
- PGID: !ENV '${PGID}'
- TZ: !ENV '${TZ}'
volumes:
- emby: /config
volumes:
emby:
device: '/path/to/containers/emby'
```
**Makejail**:
```
ARG tag=pkg
OPTION overwrite=force
OPTION from=ghcr.io/daemonless/emby:${tag}
SET allow.mlock=1
```
### Podman CLI
```bash
podman run -d --name emby \
-p 8096:8096 \
--annotation 'org.freebsd.jail.allow.mlock=true' \
-e PUID=1000 \
-e PGID=1000 \
-e TZ=UTC \
-v /path/to/containers/emby:/config \
ghcr.io/daemonless/emby:latest
```
### Ansible
```yaml
- name: Deploy emby
containers.podman.podman_container:
name: emby
image: ghcr.io/daemonless/emby:latest
state: started
restart_policy: always
env:
PUID: "1000"
PGID: "1000"
TZ: "UTC"
ports:
- "8096:8096"
volumes:
- "/path/to/containers/emby:/config"
annotation:
org.freebsd.jail.allow.mlock: "true"
```
## Parameters
### Environment Variables
| Variable | Default | Description |
|----------|---------|-------------|
| `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 |
|------|-------------|
| `/config` | Configuration and data directory |
### Ports
| Port | Protocol | Description |
|------|----------|-------------|
| `8096` | TCP | Web UI |
**Architectures:** amd64
**User:** `bsd` (UID/GID via PUID/PGID, defaults to 1000:1000)
**Base:** FreeBSD 15.0
---
Need help? Join our [Discord](https://discord.gg/Kb9tkhecZT) community.