derbynet_server

derbynet_server

Docker app from kiowa2005's Repository

Overview

DerbyNet is the new standard in race management software for Pinewood Derby events. It's free, and it's open source. With DerbyNet, multiple browsers connect to a web server running on your laptop or in the cloud.

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-browser 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   
    

Install derbynet_server on Unraid in a few clicks.

Find derbynet_server in Community Apps on your Unraid server, review the template, and click Install. Unraid handles the Docker app or plugin setup from the published template.

Open the Apps tab on your Unraid server Search Community Apps for derbynet_server Review the template variables and paths Click Install

Download Statistics

19,959
Total Downloads
3
This Month
23
Avg / Month

Total Downloads Over Time

Loading chart...

Related apps

Details

Repository
mitchellriley/derbynet_server
Last Updated2021-04-02
First Seen2020-04-22

Runtime arguments

Web UI
http://[IP]:[PORT:8050]
Network
plexnet
Shell
bash
Privileged
false

Template configuration

Webserver PortPorttcp

Container Port: 80

Target
80
Default
8050
Value
8050
Secure Webserver Port (Self Signed Certs)Porttcp

The docker has a secure webportal but the certificates are self signed.

Target
443
Default
8051
Value
8051
Timer PasswordVariable

The Timer role is intended for use by the derby-timer.jar program running on the remote timer device connected to the track (raspberrypi). By default, the Timer user has an empty password, so it is not necessary to enter any password in derby-timer.jar. However, this password, like all passwords should be updated to secure the server. Note: The password must match the password set for TIMER_PASSWORD in the timer device (raspberrypi) /etc/derbynet.conf file.

Target
TIMER_PASSWORD
Value
555
Race Crew PasswordVariable

RaceCrew, password “murphy” (as in Don Murphy, not Murphy’s Law): this role can do things like check racers in, but not erase the database.

Target
RACE_CREW_PASSWORD
Default
murphy
Value
murphy
Race Coordinator PasswordVariable

RaceCoordinator, password default is “doyourbest” This role can do anything at all.

Target
RACE_COORD_PASSWORD
Default
doyourbest
Value
doyourbest
DatabasePathrw

Container Path: /var/lib/derbynet

Target
/var/lib/derbynet
Default
/mnt/user/appdata/derbynet_server/data/
Value
/mnt/cache/appdata/derbynet_server/data
Photo PasswordVariable

You can upload photos to the web server via HTTP, using the Photo role. The default password for the Photo role is “flashbulb.” For an example of this, see extras/photostand/photostand.sh, a shell script for automated photo capture. (More description at http://www.derbytalk.com/viewtopic.php?f=25&t=8253.)

Target
PHOTO_PASSWORD
Default
flashbulb
Value
flashbulb
PUIDVariable

Container Variable: PUID

Default
99
Value
99
PGIDVariable

Container Variable: PGID

Default
100
Value
100