Build your private media server with Jellyfin

Jellyfin is a powerful, open-source software media server that puts you in full control of your media. By installing it on Olares, you can turn your device into a personal streaming platform, organizing movies, shows, and music into a beautiful library accessible securely from anywhere.

Learning objectives

In this guide, you will learn how to:

• Install and set up Jellyfin on your Olares device.
• Add and organize your media libraries.
• Optimize playback using hardware acceleration.
• Install community plugins.
• Access and stream your media securely from client devices.
• Play media on a TV and cast from Jellyfin after enabling overlay gateway.

Prerequisites

Before you begin, make sure:

• LarePass app installed on your client devices (desktop or mobile).
• Olares ID imported into the LarePass client.

Add media to Olares

Before setting up Jellyfin, you need to make sure your media is already available on Olares. You can add it in several ways:

• Upload files directly
  Upload your media to the /home/Movies/ folder in Files. For better speed and progress visibility, use the LarePass desktop client to upload.
• Mount an external drive
  After you insert a USB drive to your Olares device, it will be automatically mounted and accessible. Files in it are under the /external/ directory.
• Mount a network share
  If your media is on a NAS or other network server, you can connect it to Olares. For detailed instructions, see Mount SMB shares.

Naming conventions

Correct file naming is the key to accurate metadata and beautiful posters in Jellyfin. Follow Jellyfin's official guidelines for accurate metadata:

• Movie naming conventions
• TV shows naming conventions

Folder organization

Keep movies and TV shows in separate folders for easier management and correct metadata retrieval.

Install and configure Jellyfin

With your media ready, install Jellyfin and complete its setup wizard.

Install Jellyfin

1. Open the Market app in your Olares web interface.
2. Find Jellyfin in the Fun category or use the search bar.
3. Click Get, then Install.
4. Once the installation is finished, click Open to launch the setup wizard.

Complete the initial setup

Follow the wizard prompts to finish configuring Jellyfin.

1. Select your preferred display language and click Next.

2. Create a username and password for your Jellyfin admin account, and click Next.

3. When prompted to set up your media libraries, you can skip this step for now.

4. For metadata, select your preferred language and country and click Next.

5. For remote access, keep the default settings (unchecked) and click Next. Olares VPN will handle secure remote access.

6. Click Finish to complete the setup wizard.

7. You will be taken to the login page. Sign in with the admin credentials you just created.

   

Add media libraries

With Jellyfin installed and running, the next step is to tell it where your media is stored.

1. In Jellyfin's sidebar, go to Dashboard > Libraries > Libraries.

2. Click Add Media Library.

   

3. Configure media library settings:

   • Content type: Choose the type of media (e.g., Movies, Shows, Music). For folders containing both movies and TV shows, choose Mixed Movies and Shows.
   • Display name: Enter the name to display for the library.
     
   • Folders: Click + to add the path to your media.
     
     • Olares Files: /home/movies/<YourMediaFolder>
     • External storage: /external/<YourMediaFolder>

4. Click Ok to save, and repeat for other media types (e.g., one for "Movies", one for "TV Shows").

Once saved, Jellyfin will automatically scan your folders and begin building your library. This process may take several minutes, depending on the size of your collection.

Enable transcoding

To ensure smooth playback for high-resolution videos, enable hardware acceleration. This allows Jellyfin to use your device's hardware for faster, more efficient transcoding.

1. In the Jellyfin Dashboard (click the ≡ icon > Dashboard), go to Playback > Transcoding.

2. Under Hardware acceleration, choose your preferred method based on your Olares device's hardware.

   

Enhance experience with community plugins

You can install plugins to improve metadata, fetch better artwork, and add new features.

The process for installing plugins is the same for all. The following example uses Skin Manager, available from: https://github.com/danieladov/jellyfin-plugin-skin-manager.

1. Click Dashboard, then scroll down to Plugins.

   

2. Click Manage Repositories in the upper-right corner to go to the Repositories page, then click + New Repository to add a new repository.

3. Enter the Repository Name and Repository URL of the plugin, and click Add.

   

4. Return to Plugins, search for "Skin Manager", and open it. Then click Install. If it does not appear, refresh the page.

   

5. When the confirmation dialog appears, review the warning, then click Install.

6. After installation, a prompt will appear to restart Jellyfin. Go to the Dashboard page and click Restart.

   

7. After Jellyfin restarts, go to Dashboard > Plugins, select Installed, and verify that Skin Manager is marked Active.

   

After installing plugins, you may need to enable or configure them before they take effect. Since each plugin behaves differently, check the plugin's GitHub repository or README for setup details.

Connect and cast to a TV with overlay gateway

Overlay gateway assigns a local IP to Jellyfin so TVs on the same local network can find it to play media directly or use DLNA casting.

Use a trusted network

Overlay gateway exposes Jellyfin directly on your local network. Enable it only in a trusted network environment when you need TV discovery or DLNA casting.

Network requirements

Connect your Olares device through wired Ethernet, and keep your TV on the same local network while setting up and playing media.

Enable overlay gateway for Jellyfin

1. Open Settings, then go to Network > Overlay gateway.

2. Ensure the system-level Enable overlay gateway option is turned on. If you cannot turn it on yourself, ask the Super admin to enable it first.

3. Under Applications, find Jellyfin and enable overlay gateway for it.

4. In the confirmation dialog, click Confirm.

   

If Jellyfin is running, Olares restarts it to apply the network change. Wait until Jellyfin returns to Running before connecting from the TV.

Connect from the Jellyfin app on your TV

Use the Jellyfin app to play media directly on your TV.

1. Install the latest Jellyfin app on your TV.
2. Open the Jellyfin app on your TV, then choose the option to select or add a server. The app should automatically find Jellyfin through its overlay gateway local IP.
3. In the list, select the Jellyfin server that matches the overlay gateway IP shown for Jellyfin in Settings.
4. Sign in with the Jellyfin username and password you created during setup.
5. Open a media item and confirm that the video starts playing on the TV.

Cast from Jellyfin to a TV

Start a video in Jellyfin on Olares, then send it to a DLNA-capable TV. You do not need to open the Jellyfin app on the TV before casting.

1. Open Jellyfin on Olares.

2. Click the menu icon in the upper-left corner, then click Dashboard in the sidebar.

   

3. In the dashboard sidebar, scroll down to Plugins, then click Catalog.

4. Search for "DLNA", open the DLNA plugin result, and click Install.

5. After the plugin installs successfully, restart Jellyfin from Olares:

   a. Open Settings, then go to Applications > Jellyfin.

   b. Click Stop.

   c. After Jellyfin stops, click Resume.

6. Reopen Jellyfin on Olares.

7. Open the video you want to cast.

8. Click the cast icon (Play on) in the upper-right corner. Jellyfin should automatically find your TV.

   

9. Select the TV and confirm that the video starts playing on the TV.

Access your media library through Jellyfin clients

Get the endpoint for Jellyfin

After Jellyfin is set up and your libraries are ready, you can connect from your client devices and start streaming your media.

Enable LarePass VPN

Before you begin, make sure LarePass VPN is enabled.

If not, see Enable VPN on LarePass.

1. On Olares, open Settings, then go to Application > Jellyfin.

2. Under Entrances, click Jellyfin.

3. Make sure that Authentication level is set to Internal. If you change the setting, click Submit.

4. Under Endpoint settings, copy the URL displayed in Endpoint. Use this address as the server URL in your Jellyfin client.

   

Connect your Jellyfin client

Assume you've already installed the official Jellyfin client app on your device.

1. Open the Jellyfin client app on your device.

2. Click Add Server.

   

3. Paste your Jellyfin URL you just copied into the client and click Connect.

   

4. Sign in with your Jellyfin admin account.

You should now see your media libraries displayed in the app.

TIP

For the best experience, keep your LarePass VPN connection active when accessing Jellyfin remotely. This ensures you can always connect to your Jellyfin server securely.