# Openbooks

Openbooks is a self-hosted web application that streamlines searching for and downloading free eBooks from IRC Highway's #ebook channel, offering self-hosters an easy browser-based alternative to using IRC directly. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/645/openbooks

## Description

OpenBooks is a self-hosted web application that streamlines searching for and downloading free eBooks from IRC Highway's #ebook channel, offering self-hosters an easy browser-based alternative to using IRC directly.

## Platform availability

Available on 1 of 9 platforms: Unraid.

## Health score

12/100 (Low), based on 3 of 4 factors.
- Maintained: 0 (last commit 926 days ago)
- Popular: 12 (3 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)

## Links

- Docker Hub: https://hub.docker.com/r/evanbuss/openbooks
- Unraid: https://ca.unraid.net/apps/openbooks-1kkvw9m00n8bbq?q=Openbooks
- Official website: https://evan-buss.github.io/openbooks/
- GitHub: https://github.com/evan-buss/openbooks
- Documentation: https://evan-buss.github.io/openbooks/setup/docker/

## Common questions

### Do I need to configure or understand IRC to use OpenBooks?

No. OpenBooks removes the need to learn or understand IRC for downloading eBooks. The project's viability depends on the goodwill of IRC Highway.

### Which OpenBooks mode should I use for a web interface?

Use Server Mode to search and download eBooks through a browser. OpenBooks also offers a CLI mode for command-line use.

### How do I persist downloaded books in Docker?

Mount a host directory to /books in Docker Compose. Add --persist to the container command to enable persistent storage.

### How do I run OpenBooks under a reverse-proxy subdirectory?

Set the BASE_PATH environment variable to the subpath, for example /openbooks/. Put any additional server configuration flags in the Docker command property.

### Which Docker image tag should I use for stable self-hosting?

Use evanbuss/openbooks:latest for most users, or a version tag to pin a release. Edge is an unstable development build, and auto-updating between versions could break configuration.

---
Source: Our Local Host (https://ourlocalhost.com/app/645/openbooks), the self-hosted and open-source app directory.