1. DOMjudge overview

DOMjudge is a system for running programming contests, like the ICPC regional and world championship programming contests.

This means that teams are on-site and have a fixed time period (mostly 5 hours) and one computer to solve a number of problems (mostly 8-11). Problems are solved by writing a program in one of the allowed languages, that reads input according to the problem input specification and writes the correct, corresponding output.

The judging is done by submitting the source code of the solution to the jury. There the jury system automatically compiles and runs the program and compares the program output with the expected output.

This software can be used to handle the submission and judging during such contests. It also handles feedback to the teams and communication on problems (clarification requests). It has web interfaces for the jury, the teams (their submissions and clarification requests) and the public (scoreboard).

1.1 Features

A global overview of the features that DOMjudge provides:

• Automatic judging with distributed (scalable) judge hosts
• Web interface for portability and simplicity
• Modular system for plugging in languages/compilers and validators
• Detailed jury information (submissions, judgings, diffs) and options (rejudge, clarifications, resubmit)
• Designed with security in mind

DOMjudge has been used in many live contests (see https://www.domjudge.org/about for an overview) and is Open Source, Free Software.

1.2 Requirements

This is a (rough) list of the requirements for DOMjudge.

• At least one machine running Linux, with (sudo) root access
• nginx or Apache web server with PHP 7.0.0 or newer and PHP-command line interface
• MySQL or MariaDB database server version 5.3.3 or newer
• Compilers for the languages you want to support

A detailed list of requirements is contained in the Installation and Configuration chapter.

1.3 Copyright and licencing

DOMjudge is developed by Jaap Eldering, Nicky Gerritsen, Keith Johnson, Thijs Kinkhorst and Tobias Werth; Peter van de Werken has retired as developer. Many other people have contributed (apologies for any oversights): Michael Baer, Jeroen Bransen, Stijn van Drongelen, Rob Franken, Marc Furon, Jacob Kleerekoper, Ruud Koot, Jan Kuipers, Richard Lobb, Alex Muntada, Dominik Paulus, Bert Peters, Jeroen Schot, Matt Steele, Shuhei Takahashi, Hoai-Thu Vuong, and Jeroen van Wolffelaar. Some code has been ported from the ETH Zurich fork by Christoph Krautz, Thomas Rast et al.

DOMjudge is Copyright (c) 2004 - 2019 by the DOMjudge developers and its contributors.

DOMjudge, including its documentation, is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2, or (at your option) any later version. See the file COPYING.

This software is partly based on code by other people. These acknowledgements are made in the respective files, but we would like to name them here too (with non-GPL licences listed where applicable):

• dash (i386) is included, statically compiled from the Debian dash sources (copyright by various people under the BSD licence and a part under the GNU GPL version 2. See COPYING.BSD doc/dash.copyright for more details). Sources can be downloaded from: https://www.domjudge.org/sources/.
• basename.h is a modified version from the GNU libiberty library (copyright Free Software Foundation).
• lib.database.php by Jeroen van Wolffelaar et al.
• runguard.c was originally based on timeout from The Coroner's Toolkit by Wietse Venema.
• jscolor.js by Jan Odvarko, licensed under the GNU LGPL. It was obtained at http://jscolor.com.
• tabber.js by Patrick Fitzgerald, licensed under the MIT licence, see COPYING.MIT. It was downloaded from http://www.barelyfitz.com/projects/tabber/.
• Ace code editor by Ajax.org B.V., licensed under the BSD licence, see COPYING.BSD. It was downloaded from https://github.com/ajaxorg/ace-builds, the src-min-noconflict version.
• jQuery JavaScript library by the jQuery Foundation, licensed under the MIT licence, see COPYING.MIT. It was downloaded from http://jquery.com/.
• jQuery TokenInput by James Smith, dual licensed under the GPL and MIT licences, see COPYING and COPYING.MIT. It was downloaded from https://github.com/loopj/jquery-tokeninput.
• JavaScript Cookie by Klaus Hartl and Fagner Brack, licensed under the MIT licence, see COPYING.MIT. It was downloaded from https://github.com/js-cookie/js-cookie.
• The Spyc PHP YAML parser by Chris Wanstrath and Vlad Andersen, licensed under the MIT licence, see COPYING.MIT. It was downloaded from https://github.com/mustangostang/spyc/.
• The default compare script was included from the Kattis problemtools package, and licensed under the MIT licence, see COPYING.MIT. It was downloaded from https://github.com/Kattis/problemtools/tree/master/support/default_validator.
• The DOMjudge logo is based on the NKP 2004 logo made by Erik van Sebille.
• Several icons have been taken from the phpMyAdmin project.
• Several M4 autoconf macros from the Autoconf archive by various people are included under m4/. These are licensed under all-permissive and GPL3+ licences; see the respective files for details.

About the name and logo

The name of this judging system is inspired by a very important and well known landmark in the city of Utrecht: the dome tower, called the `Dom' in Dutch. The logo of the 2004 Dutch Programming Championships (for which this system was originally developed) depicts a representation of the Dom in zeros and ones. We based the name and logo of DOMjudge on that.

We would like to thank Erik van Sebille, the original creator of the logo. The logo is under a GPL licence, although Erik first suggested a "free as in beer" licence first: you're allowed to use it, but you owe Erik a free beer in case might you encounter him.

1.4 Contact

The DOMjudge homepage can be found at: https://www.domjudge.org/

We have a low volume mailing list for announcements of new releases.

The authors can be reached through the development mailing list: domjudge-devel@domjudge.org. You need to be subscribed before you can post. See the list information page for subscription and more details.

DOMjudge has a Slack workspace where a number of developers and users of DOMjudge linger. Feel free to drop by with your questions and comments, but note that it may sometimes take a bit longer than a few minutes to get a response, partly because people might be in different timezones.