Skip to content

Commit 50c1239

Browse files
committed
chore: update readme
1 parent 533a0d4 commit 50c1239

1 file changed

Lines changed: 91 additions & 1 deletion

File tree

README.md

Lines changed: 91 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1,91 @@
1-
# emby
1+
# emby Helm Chart
2+
![Version: 1.2.0](https://img.shields.io/badge/Version-1.2.0-informational?style=flat-square)
3+
[![Artifact Hub](https://img.shields.io/endpoint?url=https://artifacthub.io/badge/repository/emby)](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

Comments
 (0)