openkj-request-docker/README.md

OpenKJ Songbook for Docker

This is a containerized standalone songbook server for OpenKJ.

Get the server up and running:

docker build --no-cache -t openkj-server .
docker run -d --name openkj-songbook -p 80:8000 -v openkj-db:/db -e VENUE="City Karaoke" --rm openkj-server

(customize VENUE to suit)

Start up OpenKJ
Select Tools -> Settings and go to the Network tab
Set Server URL to http://localhost/api.php (assuming you're running this alongside OpenKJ)
Click Test to verify that the server is running, then click Close
Select Karaoke -> Incoming Requests
Make sure Accept Requests is checked
Make sure Automatically show this dialog on new requests is checked
Click Update Remote DB

TODO: hotspot configuration
TODO: changes to the server code to run offline (no links to external sources)