venue is configurable at runtime

README.md

@@ -1,14 +1,29 @@
-get the server up and running:
+OpenKJ Songbook for Docker
+==========================
+
+This is a containerized [standalone songbook server](https://github.com/OpenKJ/StandaloneRequestServer/) for
+[OpenKJ](https://github.com/OpenKJ/OpenKJ).
+
+Get the server up and running:
 
 ```
 docker build --no-cache -t openkj-server .
-docker run -d --name openkj -p 80:8000 -v openkj-db:/db --rm openkj-server
+docker run -d --name openkj-songbook -p 80:8000 -v openkj-db:/db -e VENUE="City Karaoke" --rm openkj-server
 ```
 
-start up OpenKJ  
-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```  
+(customize VENUE to suit)
 
-TODO: hotspot configuration
+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)