Libation for Docker

This container runs Libation with its GUI accessible by browser.

This project is hosted on github

This project is based on the excellent linuxserver.io/webtop remote desktop container.

This repo is based on OpenAudible Docker

Description

Libation runs on Linux, Mac, and Windows. This Docker container runs the latest linux version in a container running Ubuntu that is via web browser. It uses webtop by linuxserver.io.

This allows you to run Libation from a container, on the cloud, or from any Docker capable system (NAS system?).

No passwords are needed to access the web page. Only one user can view web sessions at one time-so this can't be used to share the application with multiple viewers at the same time.

Important: DO NOT expose to WAN using port forwarding. Do not use as reverse proxy unless you ensure a user/password is required.

Quick Start

docker run -d --rm -it -v $HOME/Libation:/config/Libation -p 3000:3000 -e PGID=`id -g` -e PUID=`id -u` --name Libation ghcr.io/bcnelson/libation_docker:latest

Then open your web browser to http://localhost:3000

Once Libation has been started (by visiting the web site above), your books will and setting files will be available in ~/OpenAudible

Building and running from source

git clone https://github.com/BCNelson/libation_docker.git 
cd libation_docker
just run

The run.sh file builds and runs the docker image.

If successful, the application will be up and running on port 3000 and accessible via http://localhost:3000 in a browser.

The optional -rm flag removes the container when it quits. Any downloaded or converted books will be in the docker Volume.

The run.sh script sets the UID and GID (user and group) id's for file access so files generated use your user and group IDs.

Getting latest version and upgrading

This docker image starts by installing the latest version from a GUI terminal window (so you can see the progress.) When running, you might get a notification that a new version is available. While upgrading by downloading and running the installer may work, it is probably easier to just exit the docker container, remove it, and pull it again.

docker stop openaudible
docker rm openaudible    # Not needed if the -rm flag was used

Then re-run the command(s) above to start it anew. Your settings should still be saved in the docker volume that should be mapped to a home directory.

Known limitations:

Another user logging on to the web page disconnects anyone else already connected
No password protection is enabled by default.
https not supported, but it will work using a reverse proxy like traefik or nginx.

The Docker version of OpenAudible allows user to try the software in a containerized, accessible-from-anywhere way.

TODO items

Add a user/password for accessing the VM
Perhaps experiment with Ubuntu Kiosk Mode, to disable terminal, su, etc? OpenAudible and system file browser.
lock down "su" root ability (change root password?)

Notes

This is experimental and unsupported. We hope some people find it useful. It is a neat way to run a desktop app in a container.
IMPORTANT: DO NOT EXPOSE PORT 3000 to the WAN using port forwarding or reverse proxy as there is no security on the linux webtop!
Before deleting the container and volume, if you logged into Audible, you should Log out using the Control Menu, which will delete your virtual device.
Would appreciate feedback or pull requests.
Docker is great for testing something, but we still recommend the desktop app for most users.

License

This repository is licensed under the GNU GPL 3.0 because that is what docker-webtop and OpenAudible Docker uses.