Installation

This guide will walk you through setting up a personal instance of html2rss-web using Docker and docker-compose. This is the recommended way to run the application for personal use.

Prerequisites

  • Docker and docker-compose installed on your machine.

See https://docs.docker.com/get-started/.

Step 1: Create a Project Directory

First, create a directory on your machine where you’ll store the configuration files for your html2rss-web instance.

mkdir html2rss-web;
cd html2rss-web

Step 2: Create the docker-compose.yml File

Create a file named docker-compose.yml in your html2rss-web directory and add the following content. This setup includes the web application, a browser service for rendering JavaScript-heavy pages, and a service to automatically update the application.

services:
  html2rss-web:
    image: gilcreator/html2rss-web
    restart: unless-stopped
    ports:
      - "127.0.0.1:3000:3000"
    volumes:
      - type: bind
        source: ./feeds.yml
        target: /app/config/feeds.yml
        read_only: true
    environment:
      RACK_ENV: production
      HEALTH_CHECK_USERNAME: health
      HEALTH_CHECK_PASSWORD: please-set-YOUR-OWN-veeeeeery-l0ng-aNd-h4rd-to-gue55-Passw0rd!
      BROWSERLESS_IO_WEBSOCKET_URL: ws://browserless:3001
      BROWSERLESS_IO_API_TOKEN: 6R0W53R135510

  watchtower:
    image: containrrr/watchtower
    restart: unless-stopped
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - "~/.docker/config.json:/config.json"
    command: --cleanup --interval 7200

  browserless:
    image: "ghcr.io/browserless/chromium"
    restart: unless-stopped
    ports:
      - "127.0.0.1:3001:3001"
    environment:
      PORT: 3001
      CONCURRENT: 10
      TOKEN: 6R0W53R135510

Step 3: Create the feeds.yml File

The application needs a file to store your feed configurations.
Download the default feeds.yml to get started quickly:

curl https://raw.githubusercontent.com/html2rss/html2rss-web/master/config/feeds.yml -o feeds.yml

Step 4: Launch the Application

Now, you can start the application using docker compose.

docker compose up -d

The -d flag runs the containers in the background.

Congratulations! Your personal html2rss-web instance is now running. You can access it at http://localhost:3000.

Next Steps

  • Now that your instance is running, head over to the How-To Guides to learn how to create your first feed. We recommend starting with the Creating Custom Feeds guide.
  • For a more secure setup, consider putting your instance behind a reverse proxy. You can find more information in the deployment guide.