Skip to content

Commit c5dfaa5

Browse files
authored
make install instructions nicer (#1366)
* make windows instructions nicer * make macOS instructions nicer * create page for portable packages * create page for automatic installers * remove macos.md and windows.md their contents have been moved to portable.md and automatic-installer.md * move portable to manual and add some other installation methods * community packages page * remove linux.md contents moved to other pages * add link to freebsd package * order of pages * fix broken link * fix links on index page * order of pages again * josh wording * remove macOS delete config docs * rework links * create advanced install category * separate automatic installer into OSes * move synology to advanced Every time someone complains about HWA on a NAS it's always Synology * rework index links * fix redirects * reorder advanced category * move truenas to advanced * cleanup redirects page a bit
1 parent 4a8929f commit c5dfaa5

File tree

13 files changed

+588
-607
lines changed

13 files changed

+588
-607
lines changed
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,2 @@
1+
label: 'Advanced Installation'
2+
position: 6
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,139 @@
1+
---
2+
uid: installation-advanced-community
3+
title: Community Maintained Packages
4+
description: Community maintained packages.
5+
sidebar_position: 1
6+
---
7+
8+
# Community Maintained Packages
9+
10+
These packages are maintained by community packagers independent of Jellyfin for distributions not officially supported by Jellyfin. We can't always support problems with community-maintained packages. If you encounter trouble with them, please contact their maintainers first. If you're not sure, we recommend using [container images](/docs/general/installation/container) on these systems instead.
11+
12+
## Alpine Linux
13+
14+
Jellyfin can be found in the `community` repository as
15+
[`jellyfin`](https://pkgs.alpinelinux.org/package/edge/community/x86_64/jellyfin) and
16+
[`jellyfin-web`](https://pkgs.alpinelinux.org/package/edge/community/x86_64/jellyfin-web).
17+
18+
To enable the web UI after installing `jellyfin-web`, make sure to remove the `--nowebclient` option from
19+
`/etc/conf.d/jellyfin`.
20+
21+
## Arch Linux
22+
23+
The `Extra` repository contains builds for both [`jellyfin-server`](https://archlinux.org/packages/?name=jellyfin-server) and [`jellyfin-web`](https://archlinux.org/packages/?name=jellyfin-web).
24+
`jellyfin-server` includes a hard dependency on [`jellyfin-ffmpeg`](https://archlinux.org/packages/?name=jellyfin-ffmpeg).
25+
26+
Both packages, server and web, can also be built from source at the tip of the master branch using [`jellyfin-git`](https://aur.archlinux.org/packages/jellyfin-git/).
27+
The AUR also offers each separately at [`jellyfin-server-git`](https://aur.archlinux.org/packages/jellyfin-server-git/) and [`jellyfin-web-git`](https://aur.archlinux.org/packages/jellyfin-web-git/).
28+
29+
## Fedora, CentOS and other RPM distributions
30+
31+
Builds in RPM package format are provided by RPM Fusion. Official packages are no longer provided starting with 10.9.
32+
33+
### RPM Fusion
34+
35+
1. `rpmfusion` must be enabled first
36+
37+
```sh
38+
sudo dnf install https://mirrors.rpmfusion.org/free/fedora/rpmfusion-free-release-$(rpm -E %fedora).noarch.rpm https://mirrors.rpmfusion.org/nonfree/fedora/rpmfusion-nonfree-release-$(rpm -E %fedora).noarch.rpm
39+
```
40+
41+
2. Install the `jellyfin` package, which will automatically install `jellyfin-server`, `jellyfin-web` and `jellyfin-firewalld`
42+
43+
```sh
44+
sudo dnf install jellyfin
45+
```
46+
47+
3. Enable and start the Jellyfin service:
48+
49+
```sh
50+
sudo systemctl enable --now jellyfin
51+
```
52+
53+
### Manual installation via the .rpm packages
54+
55+
1. You will need to enable `rpmfusion`, as `ffmpeg` is a dependency of the `jellyfin` server package
56+
57+
```sh
58+
sudo dnf install https://mirrors.rpmfusion.org/free/fedora/rpmfusion-free-release-$(rpm -E %fedora).noarch.rpm https://mirrors.rpmfusion.org/nonfree/fedora/rpmfusion-nonfree-release-$(rpm -E %fedora).noarch.rpm
59+
```
60+
61+
:::note
62+
63+
You do not need to manually install `ffmpeg`; it will be installed by the Jellyfin server package as a dependency.
64+
65+
:::
66+
67+
2. Install the Jellyfin server
68+
69+
```sh
70+
sudo dnf install <link to server `.rpm` file URL>
71+
```
72+
73+
3. Install the Jellyfin web interface
74+
75+
```sh
76+
sudo dnf install <link to web `.rpm` file URL>
77+
```
78+
79+
4. Enable and start the Jellyfin service:
80+
81+
```sh
82+
sudo systemctl enable --now jellyfin
83+
```
84+
85+
5. Allow Jellyfin through the firewall:
86+
87+
```sh
88+
sudo firewall-cmd --permanent --add-service=jellyfin
89+
```
90+
91+
:::note
92+
93+
This will open the following ports:
94+
95+
- `8096 TCP`, used by default for HTTP traffic; you can change this in the dashboard
96+
- `8920 TCP`, used by default for HTTPS traffic; you can change this in the dashboard
97+
- `1900 UDP`, used for service auto-discovery; this is not configurable
98+
- `7359 UDP`, used for auto-discovery; this is not configurable
99+
100+
:::
101+
102+
6. Reload the firewall to apply the new rules:
103+
104+
```sh
105+
sudo firewall-cmd --reload
106+
```
107+
108+
7. Go to `localhost:8096` or `ip-address-of-jellyfin-server:8096` to finish setup in the web UI.
109+
110+
## Gentoo
111+
112+
The Gentoo ebuild repository includes the Jellyfin package which can be installed like other software:
113+
114+
```sh
115+
emerge www-apps/jellyfin
116+
```
117+
118+
## NixOS
119+
120+
NixOS has a [module for Jellyfin](https://github.com/NixOS/nixpkgs/blob/master/nixos/modules/services/misc/jellyfin.nix),
121+
it can be enabled as follows:
122+
123+
```nix
124+
{
125+
services.jellyfin.enable = true;
126+
}
127+
```
128+
129+
For more information, refer to the [NixOS wiki](https://wiki.nixos.org/wiki/Jellyfin).
130+
131+
## Flatpak
132+
133+
The Jellyfin Server package is available on [Flathub](https://flathub.org/apps/org.jellyfin.JellyfinServer).
134+
135+
This package is provided for convenience only, and may be deprecated at any time. It is not recommended as [Flatpak themselves don't recommend the use of Flatpak for server applications](https://flatpak.org/faq/#Can_Flatpak_be_used_on_servers_too_). Please use [container images](/docs/general/installation/container) instead.
136+
137+
## FreeBSD
138+
139+
A [Third-party Jellyfin build for FreeBSD](https://github.com/Thefrank/jellyfin-server-freebsd) is available. This is not supported by Jellyfin. Please report any issues to them. Issues reported to Jellyfin about this package will be closed without further investigation.

0 commit comments

Comments
 (0)