Manual UI Installation

This guide is for users on Windows and Linux who are not using Docker and wish to run the web UI from the source.

Prerequisites

Before you begin, ensure you have the following software installed and accessible from your system's command line (PATH):

• ✅ Python 3: Required for the backend server.
• ✅ Node.js (with npm): Required for the frontend interface.
• ✅ PowerShell Core: Required to run the main Posterizarr.ps1 script.

Setup Instructions

The setup process is handled by a simple script that installs all necessary dependencies.

1. Open a terminal or command prompt.
2. Navigate into the webui directory located in the project's root folder.

   cd path/to/Posterizarr/webui
   

3. Run the appropriate setup script for your operating system:
   • On Windows:

     setup.ps1
     

     or

     setup.bat
     

   • On Linux or macOS:

     setup.sh
     

     The script will verify your prerequisites and install all required backend (Python) and frontend (Node.js) packages.

Running the UI

After the setup is complete, you need to start the backend and frontend processes in two separate terminals.

Terminal 2: Start the Frontend

# Navigate to the frontend directory
cd webui/frontend

# Run the development server
npm run build

Terminal 1: Start the Backend

# Navigate to the backend directory
cd webui/backend

# Run the Python server
python -m uvicorn main:app --host 0.0.0.0 --port 8000

Once both services are running, you can access the Posterizarr Web UI by opening your browser and navigating to: http://localhost:8000