Skip to content

Open-source Pinewood Derby race management, built around a web server and database

License

Notifications You must be signed in to change notification settings

jeffpiazza/derbynet

Repository files navigation

Please visit us at https://derbynet.org.

icon

Developing locally

To quickly get started on local development, the existing Docker image can be used to provide the web server and PHP engine, even if you don't have these installed natively on your machine.

  1. Install Apache Ant.

    1. You can install WSL and run:

      sudo apt-get update
      sudo apt-get install ant
  2. Execute ant generated from the root of the cloned repository. (This build target includes a step to generate PDF files from their ODF source files. This step will be silently skipped if the LibreOffice/OpenOffice soffice application is not available.)

  3. If desired, do one or both of the following. (If you do neither, you won't be able to connect to a hardware timer.)

    1. Execute ant timer-in-brower to build the in-browser timer interface.
    2. Execute ant timer-jar to build the derby-timer.jar timer interface.
  4. Instantiate the docker container, but use your local sources rather than those deployed in the container. PATH_TO_YOUR_DATA is a local directory where you'd like databases, photos, and other data files to be stored. PATH_TO_YOUR_REPOSITORY is the path to your local cloned repository.

    docker run --detach -p 80:80 -p 443:443 \
      --volume [** PATH TO YOUR DATA **]\lib\:/var/lib/derbynet \
      --mount type=bind,src=[** PATH TO YOUR REPOSITORY **]\website\,target=/var/www/html,readonly \
      jeffpiazza/derbynet_server   

About

Open-source Pinewood Derby race management, built around a web server and database

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published