Quick deploy guide

In alpha status, there is no publicly available online deployed app yet. Developers can deploy locally.

Simplified method

This does not work with some old Edge versions (e.g. 44) but OK with newer ones (e.g. 92.)

You need:

• Docker installed for your OS https://docs.docker.com/get-docker/
• Git or at least an unzip tool https://git-scm.com/downloads
• Web browser upgraded to a recent version (I test on Chrome 92) https://www.google.com/chrome/
• A free TCP port, 8080 by default

And it goes,

1. Download sources from the Code tab here. If you don't have Git, a Download Snapshot then unzipping should work.
2. Build and run the LilyPond web service:
   * in bash (linux, mingw etc.): ./buildbackend.sh
   * or, in Windows, start buildbackend.bat
3. Now open Chrome browser, enter in the URL bar:
   file:// followed by the path to the downloaded source code, where index.html file is located.

Safe Method

You need:

• Docker installed for your OS https://docs.docker.com/get-docker/
• Git or at least an unzip tool https://git-scm.com/downloads
• A browser upgraded to a recent version (I test on Chrome 92, Edge 44)
• Web server (Python is fine, too)
• Two free TCP ports, 8080 and 8000 by default (see also the section below)

And it goes,

1. Download sources from the Code tab here. If you don't have Git, a Download Snapshot then unzipping should work.
2. Build and run the LilyPond web service:
   * in bash (linux, mingw etc.): ./buildbackend.sh
   * in Windows, start: buildbackend.bat
3. Start a testing web server:
   * in bash (linux, mingw etc.): ./servefrontend.sh
   * in Windows, start: servefrontend.bat
4. Now open a browser, enter in the URL bar:
   localhost:8000

Port number configuration

You may want to do this if servers are not willing to start due to a TCP port
being used on your host.

• Changing backend TCP port 8080 to 8082:
  • in appconfig.js: ws: "http://localhost:8082/"
  • in the runbackend scripts (.bat and .sh): docker run -d -p127.0.0.1:8082:8080 lilypond-ws
• Changing frontend TCP port 8000 to 8002 (not present in simplified method:)
  • add command line argument after http.server in servefrontend scripts (.bat and .sh): 8002
  • browser address bar in step 4: localhost:8002

Speed Up Running Backend

If you have already built the backend web service (i.e. started the buildbackend script) once and didn't change files in the server subdirectory since then, instead of buildbackend, you can start runbackend script.

Wiki

Read this info and more here:

https://sourceforge.net/p/lets-compose/wiki/Home/