FreshRSS: Docker

FreshRSS es un agregador de canales RSS libre y ligero donde mantener al día y sincronizados vuestros feed RSS.

FreshRSS nos permitirá leer y seguir las novedades en diferentes sitios web de noticias, sin la necesidad de navegar de un sitio web a otro.

Veamos sus principales características:

• RSS y agregación ATOM.
• Opción de marcar un enlace como favorito para leerlo más adelante.
• Funcionalidades de búsqueda y filtro de ayuda.
• Estadísticas para mostrarnos la frecuencia de publicación de todos los sitios web que seguimos.
• Posibilidad de importar y exportar nuestros feeds a formato OPML
• Disponibles de varios temas creados por la comunidad.
• Se trata de una aplicación responsive, por lo que se adapta a todo tipo de pantallas.
• Auto alojado: el código es libre, ya que utiliza una licencia AGPL3, por lo que podemos alojar nuestra propia instancia, que es justo lo que haremos en esta entrada.
• Multiusuario.

Vamos a realizar unos pasos previos para preparar el entorno.

En primer lugar creamos las carpetas donde alojar el proyecto:

mkdir -p $HOME/docker/freshrss && \
cd $HOME/docker/freshrss

Ahora vamos a crear el fichero de configuración docker-compose.yml lanzando el siguiente comando:

cat << EOF > $HOME/docker/freshrss/docker-compose.yml
version: "2.1"
services:
  freshrss:
    image: ghcr.io/linuxserver/freshrss
    container_name: Freshrss
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Europe/Madrid
    volumes:
      - ~/docker/freshrss:/config
    ports:
      - 8087:80
    restart: always
EOF

Vamos a repasar los principales parámetros a modificar para adaptarlos a nuestro sistema y configuración especifica:

Parámetro	Función
PUID=1000	UID de nuestro usuario. Para saber nuestro ID ejecutar en terminal: id
PGID=1000	GID de nuestro usuario. Para saber nuestro ID ejecutar en terminal: id
TZ=Europe/Madrid	Zona horaria Europa/Madrid
~/docker/freshrss:/config	Ruta donde almacenaremos la configuración
8087:80	Puerto de gestión web 8087
restart: always	Habilitamos que tras reiniciar la maquina anfitrion vuelva a cargar el servicio

Una vez configurado, lo levantamos para ser creado y ejecutado:

docker-compose up -d

Tras haber lanzado el comando, ya tendriamos el servicio disponible, y accederiamos con un navegador web a http://ip_servidor:8087 para configurar el servidor como detallo a continuación.

Seleccionamos idioma y hacemos clic en Ir al siguiente paso

El contenedor realiza un check de instalación, hacemos clic en Ir al siguiente paso

Elegimos como base datos de almacenamiento SQLite y hacemos clic en Enviar

Creamos un usuario y contraseña de gestión y hacemos clic en Enviar

Instalación finalizada, hacemos clic en Completar instalación

TIP: Si posteriormente queremos agregar extensiones adicionales, debemos de almacenarnos en la siguiente ruta ~/docker/freshrss/www/freshrss/extensions

Y listo!