Files
openkj-request-docker/README.md
2025-10-17 09:33:20 -07:00

34 lines
1.2 KiB
Markdown

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.