Files
pgsql-jellyfin/docs/INSTALLER_QUICK_START.md
wjones c51c14efde Docs: overhaul README, centralize docs, update .gitignore
- Rewrote README.md to highlight PostgreSQL features, installer, and migration, with quick start and full docs index
- Moved all markdown documentation files to docs/ for better organization; updated links accordingly
- Added .gitignore rules to exclude all PublishProfiles folders; removed tracked publish profile XMLs
- Preserved original README as README.original.md; added README_GENERATION.md and DOCUMENTATION_ORGANIZATION.md
- Cleaned root directory, improved navigation, and clarified platform-specific instructions
2026-02-26 15:50:19 -05:00

3.0 KiB

Quick Installer Setup

Yes! You can create an installer!


Fastest Way to Get Started (5 minutes)

1. Install Inno Setup

winget install JRSoftware.InnoSetup

2. Build Installer

cd E:\Projects\pgsql-jellyfin
.\build-installer.ps1

3. Done!

Output: installer-output\JellyfinSetup-PostgreSQL-11.0.0.exe

What the Installer Does

Installs Jellyfin to C:\Program Files\Jellyfin-PostgreSQL
Creates data folder at C:\ProgramData\jellyfin
Optionally installs as Windows Service
Adds Windows Firewall exception
Creates Start Menu shortcuts
Checks for .NET 11 runtime
PostgreSQL configuration wizard
Clean uninstaller


Files You Have Now

E:\Projects\pgsql-jellyfin\
├── jellyfin-setup.iss          ← Inno Setup script (ready to use)
├── build-installer.ps1         ← PowerShell build script
├── INSTALLER_GUIDE.md          ← Complete documentation
└── lib\Release\net11.0\        ← Your built DLLs

Test the Installer

# Normal install (with UI)
.\installer-output\JellyfinSetup-PostgreSQL-11.0.0.exe

# Silent install
.\installer-output\JellyfinSetup-PostgreSQL-11.0.0.exe /VERYSILENT

# Install without service
.\installer-output\JellyfinSetup-PostgreSQL-11.0.0.exe /TASKS="!service"

Customize Before Building

Edit jellyfin-setup.iss:

Change Version

AppVersion=11.0.0  ← Change this

Change Publisher

AppPublisher=Your Name  ← Change this

Change Install Location

DefaultDirName={autopf}\Jellyfin-PostgreSQL  ← Change this

Optional: Add Icon

  1. Get/create jellyfin.ico file
  2. Place in: E:\Projects\pgsql-jellyfin\
  3. Rebuild installer

Distribution

GitHub Releases

  1. Tag version: git tag v11.0.0
  2. Create release on GitHub
  3. Upload installer: JellyfinSetup-PostgreSQL-11.0.0.exe

Direct Download

Host the .exe file on your web server

# Get certificate from DigiCert, Sectigo, etc.
signtool sign /f certificate.pfx /p password JellyfinSetup.exe

Troubleshooting

Installer doesn't build

  • Check Inno Setup is installed
  • Verify files exist in lib\Release\net11.0\
  • Run: .\build-installer.ps1 -Verbose

Service won't start

  • Check .NET 11 runtime is installed
  • Verify PostgreSQL is running
  • Check logs in C:\ProgramData\jellyfin\log\

Next Steps

  1. Install Inno Setup: winget install JRSoftware.InnoSetup
  2. Run: .\build-installer.ps1
  3. Test: Run the generated .exe file
  4. 🎉 Distribute!

Full Documentation

See INSTALLER_GUIDE.md for:

  • WiX Toolset setup (production-grade MSI)
  • MSIX packaging (Windows Store)
  • Advanced customization
  • CI/CD integration
  • Code signing details

Status: Ready to build!
Time to first installer: ~5 minutes
Result: Professional Windows installer with all features!