|
1 | | -# emby |
| 1 | +# emby Helm Chart |
| 2 | + |
| 3 | +[](https://artifacthub.io/packages/search?repo=emby) |
| 4 | + |
| 5 | +From https://emby.media: |
| 6 | +> Emby Server is a home media server built on top of other popular open source technologies such as Service Stack, jQuery, jQuery mobile, and .NET Core. It features a REST-based API with built-in documention to facilitate client development. We also have client libraries for our API to enable rapid development. |
| 7 | +
|
| 8 | +## Get Repo Info |
| 9 | + |
| 10 | + helm repo add my-emby https://pmoscode-helm.github.io/emby/ |
| 11 | + helm repo update |
| 12 | + |
| 13 | +## Install chart |
| 14 | + |
| 15 | + helm install [RELEASE_NAME] my-emby/emby |
| 16 | + |
| 17 | +The command deploys emby on the Kubernetes cluster in the default configuration. |
| 18 | + |
| 19 | +See configuration below. |
| 20 | + |
| 21 | +See [helm install](https://helm.sh/docs/helm/helm_install/) for command documentation. |
| 22 | + |
| 23 | +## Uninstall Chart |
| 24 | + |
| 25 | + helm uninstall [RELEASE_NAME] |
| 26 | + |
| 27 | +This removes all the Kubernetes components associated with the chart and deletes the release. |
| 28 | + |
| 29 | +See [helm uninstall](https://helm.sh/docs/helm/helm_uninstall/) for command documentation. |
| 30 | + |
| 31 | +## Upgrading Chart |
| 32 | + |
| 33 | + helm upgrade [RELEASE_NAME] [CHART] --install |
| 34 | + |
| 35 | +See [helm upgrade](https://helm.sh/docs/helm/helm_upgrade/) for command documentation. |
| 36 | + |
| 37 | +## Values |
| 38 | + |
| 39 | +| Key | Type | Default | Description | |
| 40 | +|-----|------|---------|-------------| |
| 41 | +| additionalVolumeMounts | list | `[]` | mountpoint(s) of the additional volumes inside the container | |
| 42 | +| additionalVolumes | list | `[]` | additional volume(s) to mount into the container | |
| 43 | +| gid | int | `100` | the GID to run emby as | |
| 44 | +| gidlist | int | `100` | a comma-separated list of additional GIDs to run emby as | |
| 45 | +| image.pullPolicy | string | `"Always"` | pull policy | |
| 46 | +| image.repository | string | `"emby/embyserver"` | repository with Emby image | |
| 47 | +| image.tag | string | `""` | current version of the image. Default: Charts appVersion. | |
| 48 | +| imagePullSecrets | list | `[]` | imagePullSecrets (not needed, if default image is used) | |
| 49 | +| ingress | object | `{"annotations":{},"className":"","enabled":false,"hosts":[{"host":"chart-example.local","paths":[{"path":"/","pathType":"ImplementationSpecific"}]}],"tls":[]}` | Configure ingress. | |
| 50 | +| livenessProbe | object | `{"httpGet":{"path":"/","port":"http"}}` | liveness probe configuration | |
| 51 | +| nfsMounts.enabled | bool | `false` | enable mounting of nfs exports | |
| 52 | +| nfsMounts.mounts[0] | object | `{"capacity":"20Gi","exportPath":"/movies","mountPath":"/movies","name":"content","nfsServer":"xxx.xxx.xxx.xxx","readOnly":false}` | name of mount | |
| 53 | +| nfsMounts.mounts[0].capacity | string | `"20Gi"` | desired capacity (usually not needed for nfs) | |
| 54 | +| nfsMounts.mounts[0].exportPath | string | `"/movies"` | export path on nfs server | |
| 55 | +| nfsMounts.mounts[0].mountPath | string | `"/movies"` | mount path on container | |
| 56 | +| nfsMounts.mounts[0].nfsServer | string | `"xxx.xxx.xxx.xxx"` | ip or dns of nfs server | |
| 57 | +| nfsMounts.mounts[0].readOnly | bool | `false` | mark mount as readonly | |
| 58 | +| persistence.accessMode | string | `"ReadWriteOnce"` | storage access mode | |
| 59 | +| persistence.enabled | bool | `false` | enable persistence? | |
| 60 | +| persistence.existingClaim | string | `nil` | existing claim | |
| 61 | +| persistence.size | string | `"20Gi"` | storage size | |
| 62 | +| persistence.storageClass | string | `nil` | desired storageClass | |
| 63 | +| podSecurityContext | object | `{}` | podSecurityContext configuration | |
| 64 | +| readinessProbe | object | `{"httpGet":{"path":"/","port":"http"}}` | readiness probe configuration | |
| 65 | +| securityContext | object | `{}` | securityContext configuration | |
| 66 | +| service.port | int | `8096` | service port | |
| 67 | +| service.type | string | `"ClusterIP"` | service type | |
| 68 | +| serviceAccount.annotations | object | `{}` | add annotations to serviceAccount | |
| 69 | +| serviceAccount.automount | bool | `true` | automatically mount a ServiceAccount's API credentials? | |
| 70 | +| serviceAccount.create | bool | `true` | enable serviceAccount | |
| 71 | +| serviceAccount.name | string | `""` | name of the serviceAccount (will be generated if empty) | |
| 72 | +| uid | int | `1000` | the UID to run emby as | |
| 73 | + |
| 74 | +## Maintainers |
| 75 | + |
| 76 | +| Name | Email | Url | |
| 77 | +| ---- | ------ | --- | |
| 78 | +| pmoscode | <info@pmoscode.de> | <https://pmoscode.de> | |
| 79 | + |
| 80 | +## Contributing |
| 81 | + |
| 82 | +If you want to add features or bugfixes, please open an issue (either feature or bug) and provide also an unittest (https://github.com/helm-unittest/helm-unittest). |
| 83 | +To make things easier, you can use Taskfile (https://taskfile.dev/) to get a small shortcut for some useful commands. |
| 84 | + |
| 85 | +You also need to copy the ".env-template" file as ".env" and configure it for your needs. |
| 86 | + |
| 87 | +The Taskfile itself needs this tools to run the tasks: |
| 88 | +- https://helm.sh/docs/intro/quickstart/ |
| 89 | +- https://github.com/norwoodj/helm-docs |
| 90 | +- https://github.com/helm-unittest/helm-unittest/ |
| 91 | +- https://github.com/pawamoy/git-changelog |
0 commit comments