Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add documentation for Truenas Scale Electric Eel (v24.10) #1228

Merged
merged 2 commits into from
Dec 15, 2024

Conversation

maru801
Copy link
Contributor

@maru801 maru801 commented Dec 15, 2024

I started working on this PR by modifying another PR, but after not having seen progress on it after I submitted my PR to it, I decided to submit again here.

The original PR credit goes to this user.
Here's a detailed list of changes from their PR compared to what I added/changed.

@felix920506
Copy link
Member

@maru801
Copy link
Contributor Author

maru801 commented Dec 15, 2024

You should remove this part https://jellyfin.org/docs/general/installation/container#truenas-scale

Done.

@jellyfin-bot
Copy link

Cloudflare Pages deployment

Latest commit 36521b441859be07fe1f72ecc32f3bfbeeb97dc9
Status ✅ Deployed!
Preview URL https://8d3ce4e5.jellyfin-org.pages.dev
Type 🔀 Preview

Copy link
Member

@felix920506 felix920506 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Few points:

  1. Replace It's with It is at the beginning of sentences
  2. Use relative links to link to other parts of the docs
  3. Remove this section of the docs https://jellyfin.org/docs/general/installation/container#truenas-scale

- Jellyfin can be installed on iX-systems' [TrueNAS SCALE](https://www.truenas.com/truenas-scale/).
- This documentation is written for TrueNAS SCALE v24.10.0 (Electric Eel) or higher.
- Consider reviewing the [TrueNAS Apps documentation](https://www.truenas.com/docs/truenasapps/) if you have not previously configured applications on your system.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This shouldn't be a list. Also, should clarify that Truenas Core is different not supported

2. Community 3rd Party App provided by ix-systems

Both methods use the official Jellyfin-provided Docker image.
This documentation will cover both install methods.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
This documentation will cover both install methods.
This document will cover both install methods.


You can configure environment variables at any time after deploying the application.

It's recommend to set the TrueNAS SCALE App system to a storage pool comprised of SSDs.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
It's recommend to set the TrueNAS SCALE App system to a storage pool comprised of SSDs.
It is recommend to set the TrueNAS SCALE App system to a storage pool comprised of SSDs.

3. config/transcodes

If you use the community app, you can allow SCALE to create datasets for the directories Jellyfin requires automatically during app installation.
You can also choose to create a static **transcodes** dataset or use temporary storage on the disk or in memory (system RAM) for transcoding.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please tell users using ram is not a good idea as it can easily run out and cause transcodes to fail. SSD is recommended as using HDD might cause slowdowns

You can also [create your own custom datasets](https://www.truenas.com/docs/scale/scaletutorials/storage/datasets/datasetsscale/) to use in the **Storage Configuration** section as `host paths` during installation.

You can organize datasets as one parent with two child datasets, for example `/mnt/tank/jellyfin/config`, `/mnt/tank/jellyfin/cache`, and so on.
With Docker, you can organzie these in any way as long as you mount them under the correct name to the Docker container.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
With Docker, you can organzie these in any way as long as you mount them under the correct name to the Docker container.
With Docker, you can organize these in any way as long as you mount them under the correct name to the Docker container.

Comment on lines +318 to +330
### Networking Settings

Select **Host Network** under **Network Configuration** if using [DLNA](/docs/general/networking/dlna/), to bind network configuration to the host network settings.
Otherwise, leave **Host Network** unselected.

![Networking](/images/docs/install-truenas-12.png)

You can accept the default port number in **WebUI Port**, which is **30013**.

You can change this to port **8096**.
Most Jellyfin clients have built-in scanning features that look for port **8096** by default.

Refer to the TrueNAS [default port list](https://www.truenas.com/docs/references/defaultports/) for a list of assigned port numbers.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

the auto discovery ports should also be configured if possible https://jellyfin.org/docs/general/networking/#static-ports

2. Jellyfin Cache Storage
3. Jellyfin Transcodes Storage

Solid state storage is recommended for config and cache storage.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

transcodes should also use SSD

You can customize limits on the CPU and memory allocated to the container Jellyfin will reside in.

- **CPUs** expects a value in **number of threads** to assign as a max CPU thread limit.
- The default is **2** which means the container will use 2 CPU threads at most.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

2 is asking for trouble. Should just tell users to set it to number of threads their CPU has

Comment on lines +530 to +534
## NVIDIA GPUs on SCALE (v24.10+)

- For users with an NVIDIA GPU, [read the v24.10 Electric Eel release notes regarding your GPU:](https://www.truenas.com/docs/scale/24.10/gettingstarted/scalereleasenotes/#upgrade-notes)
- `"Starting in 24.10, TrueNAS does not include a default NVIDIA GPU driver and instead provides a simple NVIDIA driver download option in the web interface. This allows for driver updates between TrueNAS release versions."`
- `"Users can enable driver installation from the Installed applications screen. Click Configure > Settings and select Install NVIDIA Drivers. This option is only available for users with a compatible NVIDIA GPU and no drivers installed or for users who have previously enabled the setting."`
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please add instructions on how to setup HWA on Intel and AMD on Truenas scale

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Do you mean adding instructions for how to do so within the Jellyfin dashboard?

If not, unless it's adding drivers manually to Scale, this is not needed.

For the Scale app launcher GUI, all you need to do to pass the Intel and AMD GPUs to the container is to click on the GPU option on the bottom of the launcher as shown in the document.

I also provided commented YAML lines for the same HWA passthrough.

This specific block is added because Scale no longer packages the NVIDIA GPU drivers and users need to install them separately using some built-in options in Scale.

With Docker, you can organzie these in any way as long as you mount them under the correct name to the Docker container.

It's recommended to set Jellyfin's config directory to an accessible dataset.
This will make it easy to [backup/restore your server](https://jellyfin.org/docs/general/administration/backup-and-restore).
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

use a relative link

Suggested change
This will make it easy to [backup/restore your server](https://jellyfin.org/docs/general/administration/backup-and-restore).
This will make it easy to [backup/restore your server](/docs/general/administration/backup-and-restore).

@joshuaboniface joshuaboniface changed the title Added documentation for Truenas Scale Electric Eel (v24.10) Add documentation for Truenas Scale Electric Eel (v24.10) Dec 15, 2024
@joshuaboniface joshuaboniface merged commit f973518 into jellyfin:master Dec 15, 2024
8 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants