OpenKJ Songbook for Docker
==========================

This is a containerized [standalone songbook server](https://github.com/OpenKJ/StandaloneRequestServer/) for
[OpenKJ](https://github.com/OpenKJ/OpenKJ).  The fonts and CSS files it
pulled from Google servers have been included, so the server can run 100%
off-grid.

Get the server up and running:

```docker run -d --name openkj-songbook -p 80:8000 -v openkj-db:/db -e VENUE="City Karaoke" --rm git.alfter.us/salfter/openkj-request-docker```

or

```docker compose up -d```

(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```  

For off-grid use, linux-wifi-hotspot works pretty well...set up an open
access point and scribble the IP address on a whiteboard so people can use
their phones to search songs and make requests, or point a 2nd computer at
it for the purpose.