Easy Ratings Database (ERDB) - Stateless Edition

ERDB generates poster/backdrop/logo/thumbnail images with dynamic ratings on-the-fly.

Click to view Self-Hosting Instructions (Docker / Local)

Quick Start

Install From GitHub

git clone https://github.com/realbestia1/erdb
cd erdb

1. Install dependencies: sudo npm install
2. Build: npm run build
3. Start the app: npm run start
4. App available at http://localhost:3000

By default, npm run start now launches the standalone server in multi-process mode and uses all available CPU cores on the machine. You can override it with ERDB_WORKERS=<n> npm run start, or force single-process mode with npm run start:single.

Docker

Recommended Requirements

For high performance (on-the-fly image rendering), a server with a strong CPU and plenty of RAM is recommended.

Minimum recommended:

• CPU: 4 vCPU
• RAM: 4 GB

Basic start:

docker compose up -d --build

Docker now runs a single app container in multi-process mode. By default it uses ERDB_WORKERS=auto, so the container starts one worker per available CPU core. You can pin a fixed number with ERDB_WORKERS=4 docker compose up -d --build.

Run the published image directly:

docker pull ghcr.io/realbestia1/erdb:latest
docker run -d \
  --name erdb \
  -p 3000:3000 \
  -v ./data:/app/data \
  ghcr.io/realbestia1/erdb:latest

Update the published image:

docker pull ghcr.io/realbestia1/erdb:latest
docker stop erdb
docker rm erdb
docker run -d \
  --name erdb \
  -p 3000:3000 \
  -v ./data:/app/data \
  ghcr.io/realbestia1/erdb:latest

The public port is ERDB_HTTP_PORT (default 3000) exposed directly by the app container. Set it in the .env file. Data (SQLite database and image cache) is persisted in ./data.

Custom port:

ERDB_HTTP_PORT=4000 docker compose up -d --build

CI Docker Image

The repository includes a GitHub Actions workflow at .github/workflows/docker-image.yml.

• On pull requests, it verifies that the Docker image builds successfully.
• On pushes to main, it builds and publishes the image to ghcr.io/<owner>/<repo>.
• On tags like v1.0.0, it also publishes a versioned image tag.

HuggingFace Guide (NOT RECOMMENDED)

Click to view HuggingFace instructions (to avoid bans)

(to avoid bans on HuggingFace)

1. Go to the ERDB GitHub repo: https://github.com/realbestia1/erdb
2. Click the "Fork" button in the top-right corner
3. Choose any name for the fork (do not use "erdb")

HuggingFace Steps

1. Create a new Space
2. Choose any name
3. Select Docker
4. Select Blank
5. Set it as a Public space
6. Click Create Space

Now click "Create the Dockerfile" (near the bottom of the page).

Copy and paste the content of Dockerfile.hf into the editor that opens, replacing "realbestia1" with your GitHub username.

Line to change:

RUN git clone https://github.com/realbestia1/erdb.git .

After the edit, click "Commit new file to main".

ERDB URL

To get your personal link:

1. Click the three dots in the top-right corner
2. Go to "Embed this Space"
3. Copy the Direct URL

Done! Your ERDB is ready to use on HuggingFace.

Note: to update ERDB quickly, go to the Space settings and click "Factory Rebuild" only after syncing your fork on GitHub.

API & Configuration

Full documentation, interactive API builder, and Addon generator are available on our official website:

👉 easyratingsdb.com

Please configure your instance and obtain the erdbConfig payload directly from the website. Our interactive configuration tool provides the easiest way to generate the required base64url configurations for Addon Developers.

---

---

Addon Proxy (Stremio)

ERDB can act as a proxy for any Stremio addon and always replace images (poster, background, logo, thumbnail) with the ones generated by ERDB.

Manifest Proxy (Stremio)

Stremio does not use query params here. You must generate the link from the ERDB site using the "Addon Proxy" section:

https://YOUR_ERDB_HOST/proxy/{config}/manifest.json

{config} is created automatically by the site based on the inserted parameters.

Notes

• The proxy rewrites enabled meta.poster, meta.background, meta.logo, and meta.videos[].thumbnail (types can be toggled in the Addon Proxy UI).
• The url field must point to the original addon's manifest.json.
• tmdbKey and mdblistKey are required.

for.supported.addons.mp4

for.unsupported.addons.mp4

© 2026 ERDB Project