Manual Installation

Advanced / development use

Docker is the recommended deployment method. Manual installation is intended for development or environments where Docker is unavailable.

Prerequisites

git clone https://github.com/frankieramirez/comicarr.git
cd comicarr

Using uv (recommended):

uv sync

Or using pip:

pip install -r requirements.txt

cd frontend
npm install
npm run build
cd ..

This compiles the React 19 frontend into static assets that Comicarr serves.

python3 Comicarr.py --nolaunch

The --nolaunch flag prevents Comicarr from automatically opening a browser window.

Open http://localhost:8090 in your browser and follow the Initial Setup guide.

By default, Comicarr stores its database, config, and logs in ~/.comicarr/. Override this with the --datadir flag:

python3 Comicarr.py --nolaunch --datadir /path/to/data

For development with hot-reload on the frontend:

# Terminal 1: Start the backend
python3 Comicarr.py --nolaunch

# Terminal 2: Start the frontend dev server
cd frontend
npm run dev

See the project's CONTRIBUTING.md for full development setup instructions.