add build instructions for jellyfin-web including prerequisites and steps for production build
This commit is contained in:
142
build_jellyfin_web.md
Normal file
142
build_jellyfin_web.md
Normal file
@@ -0,0 +1,142 @@
|
|||||||
|
## Build-Anleitung für jellyfin-web
|
||||||
|
|
||||||
|
### 1. Standardbuild (neueste Version)
|
||||||
|
|
||||||
|
|
||||||
|
## Voraussetzungen
|
||||||
|
- Node.js (empfohlen: Version 24)
|
||||||
|
- npm (kommt mit Node.js)
|
||||||
|
|
||||||
|
### Node-Version verwalten (Node Version Manager)
|
||||||
|
Es gibt mehrere Tools, um die Node-Version zu verwalten. Nachfolgend sind die wichtigsten Befehle für `nvm` (Linux/macOS), `nvm-windows` (Windows) und `fnm` (schneller Node-Manager) zusammengefasst — Installation, Verwendung, Auflisten und Entfernen von Versionen sowie lokale Hilfe.
|
||||||
|
|
||||||
|
- Für `nvm` (macOS / Linux):
|
||||||
|
```bash
|
||||||
|
# Node 24 installieren und verwenden
|
||||||
|
nvm install 24
|
||||||
|
nvm use 24
|
||||||
|
# Optional: als Standard setzen
|
||||||
|
nvm alias default 24
|
||||||
|
|
||||||
|
# Installierte Versionen anzeigen
|
||||||
|
nvm ls
|
||||||
|
# Verfügbare Remote-Versionen (zum Installieren)
|
||||||
|
nvm ls-remote
|
||||||
|
# Version deinstallieren
|
||||||
|
nvm uninstall 24
|
||||||
|
```
|
||||||
|
|
||||||
|
- Für `nvm-windows` (Windows):
|
||||||
|
```powershell
|
||||||
|
# Beispiel: genaue Version prüfen (z.B. 24.0.0)
|
||||||
|
nvm install 24.0.0
|
||||||
|
nvm use 24.0.0
|
||||||
|
# Nach dem Wechsel ggf. neue Shell öffnen
|
||||||
|
|
||||||
|
# Installierte Versionen anzeigen
|
||||||
|
nvm list
|
||||||
|
# Verfügbare Remote-Versionen (zum Installieren)
|
||||||
|
nvm list available
|
||||||
|
# Version deinstallieren
|
||||||
|
nvm uninstall 24.0.0
|
||||||
|
```
|
||||||
|
|
||||||
|
- Für `fnm` (fast Node Manager):
|
||||||
|
```bash
|
||||||
|
fnm install 24
|
||||||
|
fnm use 24
|
||||||
|
fnm default 24
|
||||||
|
|
||||||
|
# Installierte Versionen anzeigen
|
||||||
|
fnm list
|
||||||
|
# Verfügbare Remote-Versionen (zum Installieren)
|
||||||
|
fnm remote list
|
||||||
|
# Version deinstallieren
|
||||||
|
fnm uninstall 24
|
||||||
|
```
|
||||||
|
|
||||||
|
- Version prüfen:
|
||||||
|
```bash
|
||||||
|
node -v
|
||||||
|
```
|
||||||
|
|
||||||
|
Hinweis: Ersetze `24` bzw. `24.0.0` durch die gewünschte exakte Version, falls nötig. Wenn ein Befehl nicht gefunden wird oder Unsicherheit besteht, hilft die lokale Hilfe der Tools:
|
||||||
|
```bash
|
||||||
|
nvm --help
|
||||||
|
nvm help # für nvm-windows
|
||||||
|
fnm --help
|
||||||
|
```
|
||||||
|
|
||||||
|
## Schritte zum Bauen
|
||||||
|
|
||||||
|
1. **Repository klonen:**
|
||||||
|
```sh
|
||||||
|
git clone https://github.com/jellyfin/jellyfin-web.git
|
||||||
|
cd jellyfin-web
|
||||||
|
```
|
||||||
|
|
||||||
|
2. **Dependencies installieren:**
|
||||||
|
```sh
|
||||||
|
npm install
|
||||||
|
```
|
||||||
|
|
||||||
|
3. **Production Build erstellen:**
|
||||||
|
```sh
|
||||||
|
npm run build:production
|
||||||
|
```
|
||||||
|
|
||||||
|
Der fertige Build befindet sich dann im `dist/` Ordner.
|
||||||
|
|
||||||
|
|
||||||
|
### 2. Für ein bestimmtes Release bauen (z.B. 10.11.6)
|
||||||
|
|
||||||
|
Um Version 10.11.6 zu bauen:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 1. Repository klonen
|
||||||
|
git clone https://github.com/jellyfin/jellyfin-web.git
|
||||||
|
cd jellyfin-web
|
||||||
|
|
||||||
|
# 2. Zum gewünschten Release-Tag wechseln
|
||||||
|
git checkout v10.11.6
|
||||||
|
|
||||||
|
# 3. Dependencies installieren
|
||||||
|
npm install
|
||||||
|
|
||||||
|
# 4. Production Build
|
||||||
|
npm run build:production
|
||||||
|
```
|
||||||
|
|
||||||
|
### 3. Mit ZIP aus dem Release bauen
|
||||||
|
|
||||||
|
**Man kann auch die Source-Code-ZIP aus den Releases verwenden:**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 1. ZIP herunterladen von:
|
||||||
|
# https://github.com/jellyfin/jellyfin-web/releases/tag/v10.11.6
|
||||||
|
|
||||||
|
# 2. Entpacken
|
||||||
|
unzip jellyfin-web-10.11.6.zip
|
||||||
|
cd jellyfin-web-10.11.6
|
||||||
|
|
||||||
|
# 3. Dependencies installieren
|
||||||
|
npm install
|
||||||
|
|
||||||
|
# 4. Production Build
|
||||||
|
npm run build:production
|
||||||
|
```
|
||||||
|
|
||||||
|
### Verfügbare Build-Befehle
|
||||||
|
|
||||||
|
Basierend auf dem README gibt es folgende npm scripts:
|
||||||
|
|
||||||
|
- **`npm start`** - Development-Server mit Hot-Reload
|
||||||
|
- **`npm run build:development`** - Development Build mit Sourcemaps
|
||||||
|
- **`npm run build:production`** - Production Build (optimiert)
|
||||||
|
|
||||||
|
### Release-Links
|
||||||
|
|
||||||
|
Um die verfügbaren Releases zu sehen:
|
||||||
|
- Releases-Seite: https://github.com/jellyfin/jellyfin-web/releases
|
||||||
|
|
||||||
|
Der fertige Build befindet sich nach dem Kompilieren im **`dist/`** Ordner und kann dann auf dem Jellyfin-Server eingesetzt werden.
|
||||||
Reference in New Issue
Block a user