Ephemera on Raspberry Pi

Ephemera is a self‑hosted automation service for fetching ebooks from Anna’s Archive and LibGen. It uses Flaresolverr which is a small proxy service that solves Cloudflare, DDoS‑Guard, and similar anti‑bot challenges on behalf of other applications. It doesn’t fetch content itself — it drives a headless browser (Chromium) to load the target page, solve the challenge, and return the resulting HTML back to the caller. It’s essentially a “Cloudflare‑bypass microservice”.

🚀 Docker Installation Steps

  1. Update your system
    sudo apt update && sudo apt upgrade -y
  2. Install Docker
    curl -fsSL https://get.docker.com -o get-docker.sh
    sudo sh get-docker.sh
  3. Install Docker Compose
    sudo apt install docker-compose-plugin
  4. Add your user to the Docker group
    sudo usermod -aG docker $USER
  5. Enable Docker at boot
    sudo systemctl enable docker
  6. Reboot
    sudo reboot
  7. Test Docker
    docker run hello-world

📁 Setup Ephemera

mkdir -p ~/docker
mkdir ~/docker/ephemera

🧾 Docker Compose File

services:
  ephemera:
    image: ghcr.io/orwellianepilogue/ephemera:latest
    container_name: ephemera
    restart: unless-stopped
    ports:
      - "3033:8286"  
    environment:
      AA_BASE_URL: "https://annas-archive.org"
      FLARESOLVERR_URL: "http://flaresolverr:8191"
      AA_DONATOR_KEY: ""   # put your Anna’s Archive donator key here if you have one

      # Optional (faster downloads if you have a donator key)
      #LG_BASE_URL: "https://libgen.is"

      # Ingest folders for BookLore / Calibre-Web-Automated
      INGEST_FOLDER: "/data/ingest"

      # Notifications (Apprise URL if you want alerts)
      APPRISE_URL: ""

    volumes:
      - ephemera-data:/app/data
      - /mnt/Books:/data/ingest
      - ./downloads:/app/downloads

  flaresolverr:
    image: ghcr.io/flaresolverr/flaresolverr:latest
    container_name: flaresolverr
    restart: unless-stopped
    ports:
      - "8191:8191"

volumes:
  ephemera-data:
    driver: local

▶️ Start Ephemera

From within ~/docker/ephemera run:

docker compose up

📜 View Logs

docker logs ephemera
docker logs flaresolverr

🌐 Access Web Interface

Open your browser and go to http://<192.168.xx.xx>:3033 where http://<192.168.xx.xx> is the ip address of your Pi. You can now search for and download books.

If you find my content useful, please consider supporting this page:

☕ Buy Me a Coffee