# jellyfin | Jellyfin | Knowledge Base | Instagit

The Free Software Media System - Server Backend & API

GitHub Stars: 51.2k

Repository: https://github.com/jellyfin/jellyfin

---

## Articles

### [How to Run and Write Unit Tests for Jellyfin Server Components](/jellyfin/jellyfin/run-write-unit-tests-jellyfin-server-components)

Learn to run and write unit tests for Jellyfin server components. This guide covers xUnit, AutoFixture, and Moq, along with directory structure and coding patterns for effective testing.

- Tags: testing
- Published: 2026-05-05

### [Jellyfin Database Schema and Relationship Management: A Complete EF Core Breakdown](/jellyfin/jellyfin/jellyfin-database-schema-relationships-management)

Explore the Jellyfin database schema and EF Core relationship management. Discover how JellyfinDbContext, BaseItemEntity, and junction tables handle complex data relationships.

- Tags: deep-dive
- Published: 2026-05-05

### [How Jellyfin Transcoding Throttling and Quality Selection Works: FFmpeg Control Explained](/jellyfin/jellyfin/jellyfin-transcoding-throttling-quality-selection)

Understand Jellyfin transcoding throttling and FFmpeg control. Learn how Jellyfin manages server resources and quality for smooth playback.

- Tags: deep-dive
- Published: 2026-05-05

### [How to Implement WebSocket Handlers for Real-Time Communication in Jellyfin](/jellyfin/jellyfin/implement-websocket-handlers-real-time-communication)

Learn to implement WebSocket handlers in Jellyfin for real-time communication. Inherit from BasePeriodicWebSocketListener, override methods, and register with DI for seamless integration.

- Tags: how-to-guide
- Published: 2026-05-05

### [Understanding Jellyfin's Startup Process and Migration Stages](/jellyfin/jellyfin/jellyfin-startup-process-migration-stages-structure)

Explore Jellyfin's startup process: PreInitialisation, CoreInitialisation, and AppInitialisation. Learn how JellyfinMigrationService ensures deterministic initialization for configuration, schemas, and services.

- Tags: internals
- Published: 2026-05-05

### [How Jellyfin Handles Concurrent Streaming and Session Limits: A Technical Deep Dive](/jellyfin/jellyfin/jellyfin-concurrent-streaming-session-limits)

Discover how Jellyfin manages concurrent streaming and session limits. Learn about atomic checks and thread-safe dictionaries for optimized resource use in this technical deep dive.

- Tags: deep-dive
- Published: 2026-05-05

### [Jellyfin Library Scanning and Metadata Refresh Architecture: A Deep Dive](/jellyfin/jellyfin/jellyfin-library-scanning-metadata-refresh-architecture)

Explore the Jellyfin library scanning and metadata refresh architecture. Discover how Jellyfin uses a two-phase pipeline for efficient file system scanning and metadata provider management.

- Tags: deep-dive
- Published: 2026-05-05

### [How to Configure Prometheus Metrics Collection in Jellyfin: Complete Setup Guide](/jellyfin/jellyfin/configure-prometheus-metrics-collection-jellyfin)

Learn how to configure Prometheus metrics collection in Jellyfin with this complete setup guide. Enable the /metrics endpoint for valuable insights into your media server performance.

- Tags: how-to-guide
- Published: 2026-05-05

### [How Jellyfin Backup and Restore Works: A Deep Dive into the Full System Backup Service](/jellyfin/jellyfin/jellyfin-backup-restore-functionality)

Learn how Jellyfin backup and restore works with its ZIP-based system that archives server state, databases, and user data for easy portability and version validation. Get your full system backup now.

- Tags: deep-dive
- Published: 2026-05-05

### [Jellyfin API Versioning Strategy and Endpoint Deprecation Guide](/jellyfin/jellyfin/jellyfin-api-versioning-strategy-deprecate-endpoints)

Learn Jellyfin's API versioning strategy based on server builds and how to deprecate endpoints using .NET attributes for clear OpenAPI notices. Stay updated with your integrations.

- Tags: api-reference
- Published: 2026-05-05

### [How to Implement Custom Image Providers for Metadata Retrieval in Jellyfin](/jellyfin/jellyfin/implement-custom-image-providers-metadata-retrieval)

Learn to implement custom image providers for Jellyfin metadata retrieval. Explore IRemoteImageProvider and IDynamicImageProvider to enhance your library with external or generated images.

- Tags: how-to-guide
- Published: 2026-05-05

### [How Jellyfin's User Data Change Notification System Works: Real-Time Sync Architecture](/jellyfin/jellyfin/jellyfin-user-data-change-notification-system)

Discover how Jellyfin's User Data Change Notification System uses a WebSocket publish/subscribe architecture to broadcast real-time sync updates for playback progress and ratings across all active sessions.

- Tags: internals
- Published: 2026-05-05

### [How to Add New Configuration Options in Jellyfin: A Developer’s Guide](/jellyfin/jellyfin/process-adding-new-configuration-options-jellyfin)

Learn how to add new configuration options in Jellyfin for developers. Explore simple key/value pairs and complex POCO classes to enhance your server implementation.

- Tags: how-to-guide
- Published: 2026-05-05

### [Jellyfin Health Check Database Integration: Monitoring EF Core Connectivity](/jellyfin/jellyfin/jellyfin-health-check-system-database-integration)

Learn how Jellyfin integrates its health check system with the database using EF Core's CanConnectAsync to ensure reliable connectivity. Monitor your Jellyfin database health effortlessly.

- Tags: internals
- Published: 2026-05-05

### [How to Configure Jellyfin's Network Binding and Unix Socket Permissions: A Complete Technical Guide](/jellyfin/jellyfin/configure-jellyfin-network-binding-unix-socket-permissions)

Master Jellyfin network binding and Unix socket permissions. Learn to configure network.xml, NetworkManager, and Kestrel for robust access control in this technical guide.

- Tags: how-to-guide
- Published: 2026-05-05

### [How to Configure HTTPS/TLS Settings and Certificate Management in Jellyfin](/jellyfin/jellyfin/configure-jellyfin-https-tls-certificate-management)

Secure your Jellyfin server with HTTPS/TLS. Learn to configure TLS settings and manage certificates using its XML network configuration file for encrypted media streaming.

- Tags: how-to-guide
- Published: 2026-05-05

### [Jellyfin API Controller Structure: How to Add New Endpoints to the Media Server](/jellyfin/jellyfin/jellyfin-api-controllers-structure-add-new-endpoints)

Learn how to add new endpoints to Jellyfin API with this guide on its ASP.NET Core MVC controller structure. Understand base classes and attribute usage for seamless integration.

- Tags: api-reference
- Published: 2026-05-05

### [How Jellyfin Session Management and Playback Progress Tracking Works: A Technical Deep Dive](/jellyfin/jellyfin/jellyfin-session-management-playback-progress-tracking)

Explore Jellyfin's session management and playback progress tracking. Learn how the SessionManager and SessionInfo objects maintain user data and sync progress across devices in this technical deep dive.

- Tags: deep-dive
- Published: 2026-05-05

### [How to Implement Custom NFO Metadata Providers for Jellyfin Library Scanning](/jellyfin/jellyfin/implement-custom-nfo-metadata-providers-library-scanning)

Learn to implement custom NFO metadata providers for Jellyfin library scanning. Extend scanning by creating a class, exporting it with MEF, and implementing GetXmlFile and Fetch methods.

- Tags: how-to-guide
- Published: 2026-05-05

### [How Jellyfin Configures Its HTTP Client with Happy Eyeballs: Eliminating IPv6 Timeouts](/jellyfin/jellyfin/jellyfin-http-client-configuration-happyeyeballs)

Learn how Jellyfin configures its HTTP client with Happy Eyeballs to eliminate IPv6 timeouts. It races IPv6 and IPv4 connections for faster, more reliable access.

- Tags: internals
- Published: 2026-05-05

### [How to Set Up and Configure Live TV Streaming in Jellyfin: A Complete Guide](/jellyfin/jellyfin/setup-configure-jellyfin-live-tv-streaming)

Learn how to set up and configure Live TV streaming in Jellyfin effortlessly. This guide covers tuner hosts, EPG providers, and essential settings for seamless viewing.

- Tags: how-to-guide
- Published: 2026-05-05

### [Jellyfin Plugin System Architecture: How to Create and Load Plugins](/jellyfin/jellyfin/jellyfin-plugin-system-architecture-create-plugin)

Explore Jellyfin's plugin system architecture. Learn how to create and load plugins using DLLs and meta.json, isolating them in a custom AssemblyLoadContext to avoid conflicts.

- Tags: architecture
- Published: 2026-05-05

### [How Jellyfin Handles Transcode Directory Management and Cleanup](/jellyfin/jellyfin/jellyfin-transcode-directory-management-cleanup)

Learn how Jellyfin manages transcode directory hygiene with its four-layer system. Discover real-time deletion, scheduled tasks, and emergency purges for efficient disk space.

- Tags: internals
- Published: 2026-05-05

### [How to Configure Jellyfin API Authentication and Authorization Policies](/jellyfin/jellyfin/configure-jellyfin-api-authentication-authorization-policies)

Learn to configure Jellyfin API authentication and authorization policies. Secure your Jellyfin server by implementing custom authentication handlers and ASP.NET Core policies for robust access control.

- Tags: how-to-guide
- Published: 2026-05-05

### [How Jellyfin's Database Migration System Works: A Complete Guide to Creating Custom Migrations](/jellyfin/jellyfin/how-jellyfin-database-migration-system-works-create-custom-migrations)

Understand Jellyfin's database migration system and learn to create custom migrations. Discover how code-first migrations with Entity Framework Core ensure smooth updates and idempotence.

- Tags: deep-dive
- Published: 2026-05-05