Skip to content

Setup Instructions

Jump to bottom
Giantpizzahead edited this page Aug 11, 2020 · 7 revisions

JudgeLite was designed to be as simple to use as possible. Because of this, the setup process is very simple and easy to follow!

Installation

Linux

  1. Install Docker by following the instructions on the linked page. If you aren't comfortable with the command line, there is also a convenience script available.
  2. Make a new empty directory somewhere (this is where JudgeLite's data will be stored).
  3. Download the run_judgelite.sh script from the latest release by running the below command.
$ curl -O https://raw.githubusercontent.com/Giantpizzahead/judgelite/master/run_judgelite.sh
  1. Edit the run_judgelite.sh script with your preferred text editor. Change the value of the SECRET_KEY variable (at the top of the file). This is the password you will use to login to JudgeLite.
  2. Execute the run_judgelite.sh script as the superuser by running the below command. You may have to wait a few minutes for the script to complete.
$ sudo sh run_judgelite.sh

... and that's it! Yep. That simple. Your own JudgeLite instance is now up and running!

Windows

(Note: It's not recommended to run JudgeLite on Windows in an official environment. However, this would be really useful for testing out your problems locally as you're creating them.)

  1. Install Docker Desktop by downloading the installer from the linked page.
  2. Make a new empty folder somewhere (this is where JudgeLite's data will be stored).
  3. Copy the code from the run_judgelite.bat batch script (link), and paste it into a local file.
  4. Edit the run_judgelite.bat script by changing the value of the SECRET_KEY variable (at the top of the file). This is the password you will use to login to JudgeLite.
  5. Execute the run_judgelite.bat script by double clicking it. You may have to wait a few minutes for the script to complete. (Note: If you'd like to log JudgeLite's output, make sure to leave the console window open.)

... and that's it! JudgeLite is now up and running on your Windows machine!

Next Steps

Now that JudgeLite is setup, it's time to create some problems to submit to! Luckily, this is really simple as well! Take a look at the Creating Problems wiki page for an introduction on how to create problems.

Clone this wiki locally