Skip to content

Instantly share code, notes, and snippets.

@sdshan8

sdshan8/jellyfin-termux.md

Last active September 25, 2025 12:22
Show Gist options

  • Select an option

    Learn more about clone URLs
  • Save sdshan8/5dfcc9efbd2017d2d6feefd752f057ed to your computer and use it in GitHub Desktop.

Select an option

Learn more about clone URLs
Save sdshan8/5dfcc9efbd2017d2d6feefd752f057ed to your computer and use it in GitHub Desktop.
Download ZIP
Raw
jellyfin-termux.md

Install Jellyfin on Termux [In Proot]

This guide shows two methods of installing Jellyfin on termux

Note: only tested on aarch64/arm64

These steps are same for both methods:

  1. Update the repo
pkg update
  1. Install proot-distro and ffmpeg (ffmpeg is only required in Method 2)
pkg install proot-distro ffmpeg -y
  1. Install ubuntu and Login to it
proot-distro install ubuntu
proot-distro login ubuntu
  1. Update and upgrade the packages in ubuntu
apt update && apt upgrade -y
  1. .NET 7.0 workaround:
  • Use nano (or editor of your choice) to make a file in /etc/profile.d
nano /etc/profile.d/02-dotnet-fix.sh
  • Paste the following to set the value of DOTNET_GCHeapHardLimit to 1C0000000 (You might need to lower the value to get it to work):
export DOTNET_GCHeapHardLimit=1C0000000
  • Save and exit nano by pressing CTRL + x then y then enter
  • Make it executable
chmod +x /etc/profile.d/02-dotnet-fix.sh
  • Logout and log back into proot

Method 1:

  1. Install sudo curl and gnupg
apt install sudo curl gnupg -y

  1. Follow the step 2 to 6 in the official ubuntu installation guide for Jellyfin here

  2. Create a symbolic link for Jellyfin web client (as it's in the wrong folder)

ln -s /usr/share/jellyfin/web /usr/lib/jellyfin/bin/jellyfin-web
  1. Run Jellyfin
jellyfin
  • Note: if you get network related errors add --nonetchange parameter to jellyfin
  1. Give it a few minutes to finish startup then goto http://localhost:8096 to setup Jellyfin

Method 2:

  1. Install necessary packages (skip wget if you have it installed in termux, also replace 74 with the latest version of libicu)
apt install wget libicu74 libfontconfig1 ca-certificates -y
  1. Make a new folder in /opt by the name jellyfin and cd into it
mkdir /opt/jellyfin
cd /opt/jellyfin
  1. Download the latest generic linux build for your architecture from here with wget (make sure you download the correct architecture for you device)
wget https://repo.jellyfin.org/files/server/linux/latest-stable/arm64/jellyfin_10.10.6-arm64.tar.gz
  1. Extract it with tar
tar xvzf jellyfin_10.10.6-arm64.tar.gz
  1. Create four sub-directories for Jellyfin data
mkdir data cache config log
  1. Use nano to make a script to run Jellyfin
nano jellyfin.sh
  • Paste the following:
#!/bin/bash
JELLYFINDIR="/opt/jellyfin"

$JELLYFINDIR/jellyfin/jellyfin \
 -d $JELLYFINDIR/data \
 -C $JELLYFINDIR/cache \
 -c $JELLYFINDIR/config \
 -l $JELLYFINDIR/log \
 --ffmpeg /data/data/com.termux/files/usr/bin/ffmpeg
  • Note: if you get network related errors add --nonetchange parameter to jellyfin in the jellyfin.sh
  • Save and exit nano by pressing CTRL + x then y then enter
  1. Make it executable
chmod +x jellyfin.sh
  1. Run it
/opt/jellyfin/jellyfin.sh
  1. Give it a few minutes to finish startup then goto http://localhost:8096 to setup Jellyfin

Thanks to @vikoadi and @t-e-s-tweb for DOTNET_GCHeapHardLimit=1C0000000 and --nonetchange fix

Raw
jellyfin.sh
#!/bin/bash
JELLYFINDIR="/opt/jellyfin"
$JELLYFINDIR/jellyfin/jellyfin \
-d $JELLYFINDIR/data \
-C $JELLYFINDIR/cache \
-c $JELLYFINDIR/config \
-l $JELLYFINDIR/log \
--ffmpeg /data/data/com.termux/files/usr/bin/ffmpeg
@sdshan8
Copy link
Author

sdshan8 commented Feb 18, 2025

@sdshan8 Thank you that worked with export DOTNET_GCHeapHardLimit=80000000 // 2 GB but now I have another error connected with permission on network interfaces

[20:05:02] [INF] [1] Emby.Server.Implementations.AppBase.BaseConfigurationManager: Setting cache path: /opt/jellyfin/cache
[20:05:02] [INF] [1] Emby.Server.Implementations.ApplicationHost: Loading assemblies
[20:05:02] [ERR] [1] Jellyfin.Networking.Manager.NetworkManager: Error obtaining interfaces.
System.Net.NetworkInformation.NetworkInformationException (13): Permission denied
   at System.Net.NetworkInformation.LinuxNetworkInterface.GetLinuxNetworkInterfaces()
   at Jellyfin.Networking.Manager.NetworkManager.InitializeInterfaces()
[20:05:02] [WRN] [1] Jellyfin.Networking.Manager.NetworkManager: No interface information available. Using loopback interface(s).

sadly I don't have an android 13 device to test it, and I unable to recreate it on Android 12.
but this error shouldn't stop jellyfin from listening on localhost,
also if you get a skia related error, just install libfontconfig1

Just add parameter --nonetchange to the inside jellyfin.sh executable. Error should to away. It still listens on local host and works. Running on android 14 Debian with 2gb limit dotnet.

Thank you, I will add it to the gist for other peoples

@tribhuwan-kumar
Copy link

tribhuwan-kumar commented Sep 25, 2025

this isn't working on android 15 lineageos, sadly you just can't access the network interface from proot distro.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment