This is the Changelog for Judge0 CE. The Changelog for Judge0 Extra CE can be found here. Learn more about their difference here.

v1.13.1 (2024-04-18)

Security researcher Daniel Cooper (@stacksparrow4) found three critical vulnerabilities in Judge0 versions <= 1.13.0, which this release fixes. Thank you, Daniel, for your contribution.

Security Fixes

This release fixes the following security vulnerabilities:

CVE-2024-28185
CVE-2024-28189
CVE-2024-29021

Deployment Procedure

Judge0 is collecting telemetry data to help improve the product and understand its use in various production environments. Read more about telemetry here.

System Requirements

Please note that Judge0 has only been tested on Linux and might not work on other systems; thus, we do not provide support for it.

We recommend using Ubuntu 22.04, on which you need to do the following update of GRUB:

Use sudo to open file /etc/default/grub
Add systemd.unified_cgroup_hierarchy=0 in the value of GRUB_CMDLINE_LINUX variable.
Apply the changes: sudo update-grub
Restart your server: sudo reboot

Additionally, make sure you have Docker and Docker Compose installed.

Deployment Steps

Download and extract the release archive:

wget https://github.com/judge0/judge0/releases/download/v1.13.1/judge0-v1.13.1.zip
unzip judge0-v1.13.1.zip

Visit this website to generate a random password.
Use the generated password to update the variable REDIS_PASSWORD in the judge0.conf file.
Visit again this website to generate another random password.
Use the generated password to update the variable POSTGRES_PASSWORD in the judge0.conf file.
Run all services and wait a few seconds until everything is initialized:

cd judge0-v1.13.1
docker-compose up -d db redis
sleep 10s
docker-compose up -d
sleep 5s

Your instance of Judge0 CE v1.13.1 is now up and running; visit docs at http://<IP ADDRESS OF YOUR SERVER>:2358/docs.

v1.13.0 (2021-03-10)

Huge thanks to Filtered for sponsoring this release.

New Features

Added support for enable_network configuration flag. With the new ALLOW_ENABLE_NETWORK configuration variable, usage of this flag can be permitted or denied. Furthermore, with the new ENABLE_NETWORK configuration variable the default value of this flag can be set for every submission.
- Commits: @62a00520
Added USE_DOCS_AS_HOMEPAGE configuration variable, which allows you to show or hide Judge0 homepage. Now, by default, Judge0 homepage is empty and does not show the API documentation. However, you can still access the API documentation via /docs.
- Issues: #257

Bug Fixes

Fixed the bug where the wrong number of workers would be reported via /workers.
- Issues: #256

Security Fixes

HIGH Fixed a security bug where certain submission configuration settings would allow the user to run a program that would run infinetly long. With this fix wall_time_limit must be at least 1 second.
- Commits: @fce8d97a

Other Changes

Allow setting the max_file_size and stack_limit to 0 kB.
- Issues: #242
- Commits: @bf7c1284 @5a4b79ab
Allow setting the cpu_time_limit and cpu_extra_time to 0 seconds.
- Commits: @fce8d97a
Updated to a port 2358 as a new default port for Judge0 as a online code execution service.
- Issues: #205
- Commits: @ea9c7c97
Updated the default number of Judge0 Workers, those that acutally run the user's code, to the 2*nproc. This has been shown as a good choice for general purpose use-case.
- Commits: @113d9c74
Updated the default number of Rails threads to nproc and Rails processes to 2. This has been shown as a good choice for general purpose use-case.
- Commits: @113d9c74
Updated Let's Encrypt Docker image for deployment with HTTPS.
- Commits: @86b7f8e8
Updated Nginx proxy Docker image that is used in development setup and deployment with HTTPS.
- Commits: @83f5b175
Fixed documentation typos. Thank you @balababa.
- Pull Requests: #245
Updated base image to judge0/compilers:1.4.0 which uses updated Isolate to @ad39cc4d.

Deployment Procedure

Judge0 is collecting telemetry data to help understand how to improve the product and to better understand how Judge0 is used in various production environments. Read more about telemetry here.

Please note that Judge0 has only been tested on Linux and macOS, and might not work on Windows, thus we do not provide support for it.

With HTTP

Install Docker and Docker Compose.
Download and extract the release archive:

wget https://github.com/judge0/judge0/releases/download/v1.13.0/judge0-v1.13.0.zip
unzip judge0-v1.13.0.zip

Run all services and wait a few seconds until everything is initialized:

cd judge0-v1.13.0
docker-compose up -d db redis
sleep 10s
docker-compose up -d
sleep 5s

Your instance of Judge0 CE v1.13.0 is now available at http://<IP ADDRESS OF YOUR SERVER>:2358.

With HTTPS (SSL/TLS)

Install Docker and Docker Compose.
Download and extract the release archive:

wget https://github.com/judge0/judge0/releases/download/v1.13.0/judge0-v1.13.0-https.zip
unzip judge0-v1.13.0-https.zip

Change directory to judge0-v1.13.0-https:

cd judge0-v1.13.0-https

Edit docker-compose.yml and change variables VIRTUAL_HOST, LETSENCRYPT_HOST and LETSENCRYPT_EMAIL.
Run all services and wait a few seconds until everything is initialized:

docker-compose up -d db redis
sleep 10s
docker-compose up -d
sleep 5s

Your instance of Judge0 CE v1.13.0 is now available at https://<YOUR DOMAIN>.

v1.12.0 (2020-10-18)

New Features

Added support for invalidating statistics cache using the invalidate_cache query parameter.
- Commits: @561c2a30
Added rake task judge0:run_in_queue to manually run submissions that might have stuck in the In Queue state.
- Commits: @c3b87d23
Added support for specifying CALLBACKS_MAX_TRIES and CALLBACKS_TIMEOUT. This is a global configuration that applies to all submissions that have defined webhooks (HTTP callbacks).
- Commits: @c4bb76ec
Added support for submission caching to reduce the number of unnecessary database hits. Cache duration can be controlled with the SUBMISSION_CACHE_DURATION variable which is currently set to 1 second by default. Submissions are only cached for GET /submissions/<token> route. Cache files are written to the server's file system and are automatically cleared every day at midnight. This is the first step toward more serious submission caching in the future.
- Commits: @7a33c61c @0b344920

Improvements

Update PostgreSQL to 13.0 and Redis to 6.0.
- Commits: @05330f11 @be300efa
Reschedule failed jobs after 0.1 seconds with 100 attempts.
- Commits: @f7265cf8 @e003c888
Send only submission ID to the worker and not the whole serialized submission.
- Commits: @f7265cf8 @4222c090
Automatically restart Judge0 server without the need for Docker restart policies. Use the RESTART_MAX_TRIES variable to specify the maximum number of restart tries.
- Commits: @65756516 @c0fd97e2

Bug Fixes

Fixed a bug in the is_project method of submission model where an exception was raised and not handled properly due to unknown language.
- Commits: @6426ac61

Other Changes

Use Docker volumes for storing Postgres and Redis data instead of mounting directories. This is now the new recommended setting.
- Commits: @600f5aaa
Added Resque Web to the development stack.
- Commits: @3762a635
Changed binding ports for Nginx and documentation server in the development stack. Nginx is now bound to port 80, and the development server to port 3001.
- Commits: @3762a635
Removed port bindings of Postgres and Redis in the development stack.
- Commits: @3762a635
Added PgBouncer to the development stack for testing and experimenting.
- Commits: @24b3227a
Changed recommended values for POSTGRES_DB and POSTGRES_USER. Both are now judge0.
- Commits: @745f4455

Deployment Procedure

Judge0 is collecting telemetry data to help understand how to improve the product and to better understand how Judge0 is used in various production environments. Read more about telemetry here.

Please note that Judge0 has only been tested on Linux and macOS, and might not work on Windows, thus we do not provide support for it.

With HTTP

Install Docker and Docker Compose.
Download and extract release archive:

wget https://github.com/judge0/judge0/releases/download/v1.12.0/judge0-v1.12.0.zip
unzip judge0-v1.12.0.zip

Run all services and wait a few seconds until everything is initialized:

cd judge0-v1.12.0
docker-compose up -d db redis
sleep 10s
docker-compose up -d
sleep 5s

Your instance of Judge0 v1.12.0 is now available at http://<IP ADDRESS OF YOUR SERVER>.

With HTTPS (SSL/TLS)

Install Docker and Docker Compose.
Download and extract release archive:

wget https://github.com/judge0/judge0/releases/download/v1.12.0/judge0-v1.12.0-https.zip
unzip judge0-v1.12.0-https.zip

Change directory to judge0-v1.12.0-https:

cd judge0-v1.12.0-https

Edit docker-compose.yml and change variables VIRTUAL_HOST, LETSENCRYPT_HOST and LETSENCRYPT_EMAIL.
Run all services and wait a few seconds until everything is initialized:

docker-compose up -d db redis
sleep 10s
docker-compose up -d
sleep 5s

Your instance of Judge0 v1.12.0 is now available at https://<YOUR DOMAIN>.

v1.11.0 (2020-09-09)

New Features

Added queue size into response of /workers.
- Issues: #210
- Commits: @7ee1b10c

Improvements

Set configuration defaults even if judge0.conf is not present. Thank you @vvalchev.
- Issues: #206
- Commits: @8c42f7be

Other Changes

Updated documentation with some better explanation on the use of base64_encoded query parameter. Thank you @mejibyte.

Deployment Procedure

Judge0 is collecting telemetry data to help understand how to improve the product and to better understand how Judge0 is used in various production environments. Read more about telemetry here.

Please note that Judge0 has only been tested on Linux and might not work on Windows or macOS, thus we do not provide support for these systems.

With HTTP

Install Docker and Docker Compose.
Download and extract release archive:

wget https://github.com/judge0/judge0/releases/download/v1.11.0/judge0-v1.11.0.zip
unzip judge0-v1.11.0.zip

Run all services and wait few seconds until everything is initialized:

cd judge0-v1.11.0
docker-compose up -d db redis
sleep 10s
docker-compose up -d
sleep 5s

Your instance of Judge0 v1.11.0 is now available at http://<IP ADDRESS OF YOUR SERVER>.

With HTTPS (SSL/TLS)

Install Docker and Docker Compose.
Download and extract release archive:

wget https://github.com/judge0/judge0/releases/download/v1.11.0/judge0-v1.11.0-https.zip
unzip judge0-v1.11.0-https.zip

Change directory to judge0-v1.11.0-https:

cd judge0-v1.11.0-https

Edit docker-compose.yml and change variables VIRTUAL_HOST, LETSENCRYPT_HOST and LETSENCRYPT_EMAIL.
Run all services and wait few seconds until everything is initialized:

docker-compose up -d db redis
sleep 10s
docker-compose up -d
sleep 5s

Your instance of Judge0 v1.11.0 is now available at https://<YOUR DOMAIN>.

v1.10.0 (2020-07-27)

New Features

Added support for multi-file programs in the terms of adding a new special language called Multi-file program. In total there are now 47 active languages.

ID	Name	Note
89	Multi-file program

Multi-file programs allow you specify your own compilation and execution scripts that Judge0 will use.

To use multi-file program feature you need to choose a language called Multi-file program whoose ID is 89. Moreover, you need to send all program files with additional_files attribute. With multi-file programs attribute source_code cannot be used, i.e. all files should be sent with additional_files attribute.

For the Judge0 to know how to compile and execute your multi-file program you need to provide two special files that should be available in the root of the .zip archive that you are sending with additional_files attribute. These files should be named compile and run, and are expected to be Bash scripts that know how to compile and execute your multi-file program. If your multi-file program does not need compilation step, then you don't need to provide compile script. Take a look at this example to learn how to use this feature to compile and run multi-file C++ project that uses CMake.

Other Changes

Updated gems.

Deployment Procedure

Judge0 is collecting telemetry data to help understand how to improve the product and to better understand how Judge0 is used in various production environments. Read more about telemetry here.

With HTTPS (SSL/TLS)

Install Docker and Docker Compose.
Download and extract release archive:

wget https://github.com/judge0/api/releases/download/v1.10.0/judge0-v1.10.0-https.zip
unzip judge0-v1.10.0-https.zip

Change directory to judge0-v1.10.0-https:

cd judge0-v1.10.0-https

Edit docker-compose.yml and change variables VIRTUAL_HOST, LETSENCRYPT_HOST and LETSENCRYPT_EMAIL.
Run all services and wait few seconds until everything is initialized:

docker-compose up -d db redis
sleep 10s
docker-compose up -d
sleep 5s

Your instance of Judge0 v1.10.0 is now available at https://<YOUR DOMAIN>.

With HTTP

Install Docker and Docker Compose.
Download and extract release archive:

wget https://github.com/judge0/api/releases/download/v1.10.0/judge0-v1.10.0.zip
unzip judge0-v1.10.0.zip

Run all services and wait few seconds until everything is initialized:

cd judge0-v1.10.0
docker-compose up -d db redis
sleep 10s
docker-compose up -d
sleep 5s

Your instance of Judge0 v1.10.0 is now available at http://<IP ADDRESS OF YOUR SERVER>.

v1.9.0 (2020-06-10)

Huge thanks to Filtered for sponsoring this release.

New Features

Added support for configuration variable RAILS_SERVER_PROCESSES which allows to create multiple processes for handling requests.

Other Changes

Updated gems.

Deployment Procedure

Judge0 is collecting telemetry data to help understand how to improve the product and to better understand how Judge0 is used in various production environments. Read more about telemetry here.

With HTTPS (SSL/TLS)

Install Docker and Docker Compose.
Download and extract release archive:

wget https://github.com/judge0/api/releases/download/v1.9.0/judge0-v1.9.0-https.zip
unzip judge0-v1.9.0-https.zip

Change directory to judge0-v1.9.0-https:

cd judge0-v1.9.0-https

Edit docker-compose.yml and change variables VIRTUAL_HOST, LETSENCRYPT_HOST and LETSENCRYPT_EMAIL.
Run all services and wait few seconds until everything is initialized:

docker-compose up -d db redis
sleep 10s
docker-compose up -d
sleep 5s

Your instance of Judge0 v1.9.0 is now available at https://<YOUR DOMAIN>.

With HTTP

Install Docker and Docker Compose.
Download and extract release archive:

wget https://github.com/judge0/api/releases/download/v1.9.0/judge0-v1.9.0.zip
unzip judge0-v1.9.0.zip

Run all services and wait few seconds until everything is initialized:

cd judge0-v1.9.0
docker-compose up -d db redis
sleep 10s
docker-compose up -d
sleep 5s

Your instance of Judge0 v1.9.0 is now available at http://<IP ADDRESS OF YOUR SERVER>.

v1.8.0 (2020-05-28)

Huge thanks to Filtered for sponsoring this release.

New Features

Added 4 new languages, and in total there are now 46 active languages.

ID	Name	Note
85	Perl (5.28.1)	Sponsored by Filtered.
86	Clojure (1.10.1)	Sponsored by Filtered.
87	F# (.NET Core SDK 3.1.202)	Sponsored by Filtered.
88	Groovy (3.0.3)	Sponsored by Filtered.

Bug Fixes

Fixed /statistics route caching.
- Issues: #184
- Commits: @83c5cfc6

Other Changes

Updated gems.
- Commits: @0c766273 @700e6582
Increased default CPU_TIME_LIMIT to 5, CPU_EXTRA_TIME to 1, MAX_CPU_EXTRA_TIME to 5 and WALL_TIME_LIMIT to 10 seconds.
- Commits: @77961ab9
Changed HOME environment variable value for sandbox to /tmp.
- Commits: @77961ab9
Updated isolate to @9be3ff6f.

Deployment Procedure

Judge0 API is collecting telemetry data to help understand how to improve the product and to better understand how the Judge0 API is used in various production environments. Read more about telemetry here.

With HTTPS (SSL/TLS)

Install Docker and Docker Compose.
Download and extract release archive:

wget https://github.com/judge0/api/releases/download/v1.8.0/judge0-api-v1.8.0-https.zip
unzip judge0-api-v1.8.0-https.zip

Change directory to judge0-api-v1.8.0-https:

cd judge0-api-v1.8.0-https

Edit docker-compose.yml and change variables VIRTUAL_HOST, LETSENCRYPT_HOST and LETSENCRYPT_EMAIL.
Run all services and wait few seconds until everything is initialized:

docker-compose up -d db redis
sleep 10s
docker-compose up -d
sleep 5s

Your instance of Judge0 API v1.8.0 is now available at https://<YOUR DOMAIN>.

With HTTP

Install Docker and Docker Compose.
Download and extract release archive:

wget https://github.com/judge0/api/releases/download/v1.8.0/judge0-api-v1.8.0.zip
unzip judge0-api-v1.8.0.zip

Run all services and wait few seconds until everything is initialized:

cd judge0-api-v1.8.0
docker-compose up -d db redis
sleep 10s
docker-compose up -d
sleep 5s

Your instance of Judge0 API v1.8.0 is now available at http://<IP ADDRESS OF YOUR SERVER>.

v1.7.1 (2020-05-06)

Bug Fixes

Compile Swift before executing since default file size limit of 1MB for execution is not enough for Swift to run successfully. Compilation has a file size limit of 4MB by default which seems to be enough for Swift to compile. Thanks @OliverwengFiltered.
- Issues: #154
- Commits: @371e2463
Fixed environment loading for Telemetry Client.
- Commits: @bd16119c

Other Changes

Set VIRTUAL_HOST environment variable in Dockerfile to value 3000.
Updated Telemetry Client to version c62fa63d.
Added separated Docker Compose files for server and workers.
Renamed service worker to workers and api to server.

Deployment Procedure

Judge0 API is collecting telemetry data to help understand how to improve the product and to better understand how the Judge0 API is used in various production environments. Read more about telemetry here.

With HTTPS (SSL/TLS)

Install Docker and Docker Compose.
Download and extract release archive:

wget https://github.com/judge0/api/releases/download/v1.7.1/judge0-api-v1.7.1-https.zip
unzip judge0-api-v1.7.1-https.zip

Change directory to judge0-api-v1.7.1-https:

cd judge0-api-v1.7.1-https

Edit docker-compose.yml and change variables VIRTUAL_HOST, LETSENCRYPT_HOST and LETSENCRYPT_EMAIL.
Run all services and wait few seconds until everything is initialized:

docker-compose up -d db redis
sleep 10s
docker-compose up -d
sleep 5s

Your instance of Judge0 API v1.7.1 is now available at https://<YOUR DOMAIN>.

With HTTP

Install Docker and Docker Compose.
Download and extract release archive:

wget https://github.com/judge0/api/releases/download/v1.7.1/judge0-api-v1.7.1.zip
unzip judge0-api-v1.7.1.zip

Run all services and wait few seconds until everything is initialized:

cd judge0-api-v1.7.1
docker-compose up -d db redis
sleep 10s
docker-compose up -d
sleep 5s

Your instance of Judge0 API v1.7.1 is now available at http://<IP ADDRESS OF YOUR SERVER>.

v1.7.0 (2020-05-05)

Huge thanks to sponsors of this release: Filtered and Evalart.

New Features

Added 10 new languages, and in total there are now 42 active languages.

ID	Name	Note
75	C (Clang 7.0.1)
76	C++ (Clang 7.0.1)
77	COBOL (GnuCOBOL 2.2)	Sponsored by Evalart.
78	Kotlin (1.3.70)	Sponsored by Filtered.
79	Objective-C (Clang 7.0.1)	Sponsored by Filtered and Evalart.
80	R (4.0.0)	Sponsored by Filtered.
81	Scala (2.13.2)	Sponsored by Filtered.
82	SQL (SQLite 3.27.2)	Sponsored by Filtered. (*)
83	Swift (5.2.3)	Sponsored by Filtered and Evalart.
84	Visual Basic.Net (vbnc 0.0.0.5943)	Sponsored by Filtered.

(*) Watch this asciicast to learn how to use this language.

Other Changes

Increased default MAX_MEMORY_LIMIT to 512000.
- Commits: @3dcbfc96
Set compile CPU time limit to MAX_CPU_TIME_LIMIT.
- Commits: @3dcbfc96
Set compile wall time limit to MAX_WALL_TIME_LIMIT.
- Commits: @3dcbfc96
Redirect input from /dev/null when compiling. Thank you @gollux for your help.
- Commits: @42b89a7c

Deployment Procedure

With HTTPS (SSL/TLS)

Install Docker and Docker Compose.
Download and extract release archive:

wget https://github.com/judge0/api/releases/download/v1.7.0/judge0-api-v1.7.0-https.zip
unzip judge0-api-v1.7.0-https.zip

Change directory to judge0-api-v1.7.0-https:

cd judge0-api-v1.7.0-https

Edit docker-compose.yml and change variables VIRTUAL_HOST, LETSENCRYPT_HOST and LETSENCRYPT_EMAIL.
Run all services and wait few seconds until everything is initialized:

docker-compose up -d db redis
sleep 10s
docker-compose up -d
sleep 5s

Your instance of Judge0 API v1.7.0 is now available at https://<YOUR DOMAIN>.

With HTTP

Install Docker and Docker Compose.
Download and extract release archive:

wget https://github.com/judge0/api/releases/download/v1.7.0/judge0-api-v1.7.0.zip
unzip judge0-api-v1.7.0.zip

Run all services and wait few seconds until everything is initialized:

cd judge0-api-v1.7.0
docker-compose up -d db redis
sleep 10s
docker-compose up -d
sleep 5s

Your instance of Judge0 API v1.7.0 is now available at http://<IP ADDRESS OF YOUR SERVER>.

v1.6.0 (2020-05-01)

New Features

Added support for automatically redirecting stderr to stdout of the running program with the configuration flag redirect_stderr_to_stdout. Added configuration variable REDIRECT_STDERR_TO_STDOUT that can be used for setting default behaviour for every submission.
- Commits: @8e6617aa
Added configuration variable DISALLOW_ORIGIN that can be used for disabling CORS only for specific origins.
- Commits: @f61b5496 @a927c9db
Added configuration variables ALLOW_IP and DISALLOW_IP that can be used for allowing/disallowing only specific IP addresses that can use instance of Judge0 API.
- Commits: @4fd0f34b
Added support for built in maintenance mode that can be enabled with configuration variables MAINTENANCE_MODE and MAINTENANCE_MESSAGE. In maintenance mode clients cannot create or delete submissions i.e. they cannot create new database changes.
- Commits: @201221e2
Added support for universal field * which returns all attributes of a submission.
- Commits: @521cc2e2
Added route GET /statistics which returns some basic and useful information about Judge0 API instance. Statistic report is cached for 10 minutes.
- Commits: @a24db632 @621c50f1 @eead8067
Added basic support for callbacks which are called with HTTP verb PUT.
- Pull Requests: #98
- Issues: #33
- Commits: @41e846b1
Added support for presetting custom additional files in a sandbox.
- Issues: #32 #88
- Commits: @7829db87 @6d1f4293 @6573c52f
Added routes GET /submissions/batch and POST /submissions/batch batch create and show or submissions.
- Issues: #34
- Commits: @6420156b @87859b58 @595c7e11 @04c900c9 @cb676d6c

Improvements

Use Redis queue with name that corresponds with the current Judge0 API version. This allows multiple instances of different versions of Judge0 API to use the same Redis instance.
- Commits: @dd6b62d7
Refactored submission field checking.
- Commits: @9acefdbc
Refactored setting up of default values.
- Commits: @a14ae5d5

Bug Fixes

Fixed a bug that ignored custom setting of configuration variables enable_per_process_and_thread_time_limit and enable_per_process_and_thread_memory_limit.
- Commits: @a6f693a0
Fixed a bug where cgroups flags for isolate were chosen in the wrong conditions.
- Commits: @4116b9cb
Fixed a bug that caused Internal Error because sandbox cleanup failed.
- Pull Requests: #126
- Issues: #123 #143
- Commits: @514aec53
Fixed a bug where low memory_limit would cause Internal Error. Minimum required value for memory_limit is now 2048.
- Commits: @655ccf27

Security Fixes

Fixed a bug that allowed creation of an arbitrary size of the compile output.
- Commits: @5fc7b823

Other Changes

Do not implicitly force wide open CORS settings when in development mode. I.e. variable ALLOW_ORIGIN can now also be used in development mode.
- Commits: @a3a24c5c
Removed output of configuration settings when server or worker starts.
- Commits: @7061de7a
Updated all the gems except Rails to the latest versions.
- Commits: @230c7a77 @69a9fe11 @095588e6
Changed default value of enable_per_process_and_thread_memory_limit to false.
- Commits: @4116b9cb
Don't show total number of workers in /workers that is determined with configuration variable COUNT because that number is not relevant.
- Commits: @99939b89
Changed the default port to 80 in Docker Compose file.
- Commits: @6ab67d6b
Limited the log size to 100 MB in Docker Compose file.
- Commits: @435c7d79
Added logging to run-workers script.
- Commits: @381265a2
Updated dummy client default values.
Added Docker Compose file for HTTPS support.
Refactored all development and production scripts from scripts directory.
Refactored judge0-api.conf file.

Deployment Procedure

With HTTPS (SSL/TLS)

Install Docker and Docker Compose.
Download and extract release archive:

wget https://github.com/judge0/api/releases/download/v1.6.0/judge0-api-v1.6.0-https.zip
unzip judge0-api-v1.6.0-https.zip

Change directory to judge0-api-v1.6.0-https:

cd judge0-api-v1.6.0-https

Edit docker-compose.yml and change variables VIRTUAL_HOST, LETSENCRYPT_HOST and LETSENCRYPT_EMAIL.
Run all services and wait few seconds until everything is initialized:

docker-compose up -d db redis nginx letsencrypt
sleep 10s
docker-compose up -d
sleep 5s

Your instance of Judge0 API v1.6.0 is now available at https://<YOUR DOMAIN>.

With HTTP

Install Docker and Docker Compose.
Download and extract release archive:

wget https://github.com/judge0/api/releases/download/v1.6.0/judge0-api-v1.6.0.zip
unzip judge0-api-v1.6.0.zip

Run all services and wait few seconds until everything is initialized:

cd judge0-api-v1.6.0
docker-compose up -d db redis
sleep 10s
docker-compose up -d
sleep 5s

Your instance of Judge0 API v1.6.0 is now available at http://<IP ADDRESS OF YOUR SERVER>.

v1.5.0 (2020-01-01)

New Features

Added 30 new languages, archived 42 languages and kept active 2 languages from the last release. In total, there are now 32 active languages that can be used and all are updated to their latest versions as of the date of this release. Archived languages cannot be used anymore. Following table shows a status of every language that API supports.
- Issues: #51 #90 #106 #131
- Commits: @f86a546c

ID	Name	Status
1	Bash (4.4)	archived
2	Bash (4.0)	archived
3	Basic (fbc 1.05.0)	archived
4	C (gcc 7.2.0)	archived
5	C (gcc 6.4.0)	archived
6	C (gcc 6.3.0)	archived
7	C (gcc 5.4.0)	archived
8	C (gcc 4.9.4)	archived
9	C (gcc 4.8.5)	archived
10	C++ (g++ 7.2.0)	archived
11	C++ (g++ 6.4.0)	archived
12	C++ (g++ 6.3.0)	archived
13	C++ (g++ 5.4.0)	archived
14	C++ (g++ 4.9.4)	archived
15	C++ (g++ 4.8.5)	archived
16	C# (mono 5.4.0.167)	archived
17	C# (mono 5.2.0.224)	archived
18	Clojure (1.8.0)	archived
19	Crystal (0.23.1)	archived
20	Elixir (1.5.1)	archived
21	Erlang (OTP 20.0)	archived
22	Go (1.9)	archived
23	Haskell (ghc 8.2.1)	archived
24	Haskell (ghc 8.0.2)	archived
25	Insect (5.0.0)	archived
26	Java (OpenJDK 9 with Eclipse OpenJ9)	archived
27	Java (OpenJDK 8)	archived
28	Java (OpenJDK 7)	archived
29	JavaScript (nodejs 8.5.0)	archived
30	JavaScript (nodejs 7.10.1)	archived
31	OCaml (4.05.0)	archived
32	Octave (4.2.0)	archived
33	Pascal (fpc 3.0.0)	archived
34	Python (3.6.0)	archived
35	Python (3.5.3)	archived
36	Python (2.7.9)	archived
37	Python (2.6.9)	archived
38	Ruby (2.4.0)	archived
39	Ruby (2.3.3)	archived
40	Ruby (2.2.6)	archived
41	Ruby (2.1.9)	archived
42	Rust (1.20.0)	archived
43	Plain Text	Renamed from `Text (plain text)`.
44	Executable	Not changed.
45	Assembly (NASM 2.14.02)	NEW
46	Bash (5.0.0)	NEW
47	Basic (FBC 1.07.1)	NEW
48	C (GCC 7.4.0)	NEW
49	C (GCC 8.3.0)	NEW
50	C (GCC 9.2.0)	NEW
51	C# (Mono 6.6.0.161)	NEW
52	C++ (GCC 7.4.0)	NEW
53	C++ (GCC 8.3.0)	NEW
54	C++ (GCC 9.2.0)	NEW
55	Common Lisp (SBCL 2.0.0)	NEW
56	D (DMD 2.089.1)	NEW
57	Elixir (1.9.4)	NEW
58	Erlang (OTP 22.2)	NEW
59	Fortran (GFortran 9.2.0)	NEW
60	Go (1.13.5)	NEW
61	Haskell (GHC 8.8.1)	NEW
62	Java (OpenJDK 13.0.1)	NEW
63	JavaScript (Node.js 12.14.0)	NEW
64	Lua (5.3.5)	NEW
65	OCaml (4.09.0)	NEW
66	Octave (5.1.0)	NEW
67	Pascal (FPC 3.0.4)	NEW
68	PHP (7.4.1)	NEW
69	Prolog (GNU Prolog 1.4.5)	NEW
70	Python (2.7.17)	NEW
71	Python (3.8.1)	NEW
72	Ruby (2.7.0)	NEW
73	Rust (1.40.0)	NEW
74	TypeScript (3.7.4)	NEW

Added route GET /languages/:id for getting all attributes of specified language.
- Commits: @2a31e963
Added route GET /languages/all for getting a list of all languages (archived and active).
- Commits: @2a31e963
Added route DELETE /submissions/:token for deleting specified submission. Only authorized requests (users) are allowed to delete a submission.
- Commits: @3365e3c8
Added configuration variable ENABLE_SUBMISSION_DELETE with default value set to false. By default you cannot delete a submission as long as this variable is set to false. When set to true then only authorized requests (users) can delete specific submission.
- Commits: @79e1de95
Added info routes GET /about, GET /version, GET /license and GET /isolate. Last route GET /isolate returns result from isolate --version command.
- Commits: @9f5202a5

Improvements

Updated base image to judge0/api-base:1.0.0 which uses Debian "buster" and has installed Ruby 2.7.0.
- Issues: #113
- Commits: @f86a546c
Improved handling of an server error when one or more submission attributes cannot be serialized to JSON without Base64 encoding. User now gets an error with instructions to use base64_encoded=true query parameter.
- Issues: #107 #129 #130
- Commits: @cdcaa512

Bug Fixes

Fixed example in configuration for using ALLOW_ORIGIN variable with multiple origins.
- Commits: @21d0202a
Fixed a bug where value of MAX_MAX_PROCESSES_AND_OR_THREADS was used as default value for max_processes_and_or_threads attribute of submission, whereas MAX_PROCESSES_AND_OR_THREADS should be used.
- Commits: @563f8ea2

Other Changes

Increased maximum allowed compiler_options and command_line_arguments length to 512 characters.
- Issues: #122
- Commits: @3d4df3bf
Increased default value of MAX_PROCESSES_AND_OR_THREADS to 60.
- Commits: @563f8ea2
Increased default value of MAX_MAX_PROCESSES_AND_OR_THREADS to 120.
- Commits: @563f8ea2
Changed default value of RAILS_ENV to production.
- Commits: @be55ca65
Changed default value of INTERVAL to 0.1.
- Commits: @be55ca65
Updated year in LICENSE.
- Commits: @679fb2ba
Added environment variables JUDGE0_{HOMEPAGE,SOURCE_CODE,MAINTAINER,VERSION}. Isolate sandbox inherits these variables and they are now available for use in user code.
- Commits: @9f5202a5

Deployment Procedure

Install Docker and Docker Compose.
Download and extract release archive:

wget https://github.com/judge0/api/releases/download/v1.5.0/judge0-api-v1.5.0.zip
unzip judge0-api-v1.5.0.zip

Run all services and wait few seconds until everything is initialized:

cd judge0-api-v1.5.0
docker-compose up -d db redis
sleep 10s
docker-compose up -d
sleep 5s

Your instance of Judge0 API v1.5.0 is now available at http://<IP OF YOUR SERVER>:3000.

v1.4.0 (2019-10-31)

New Features

Added support for compiler_options and command_line_arguments.
Added configuration variables ENABLE_COMPILER_OPTIONS, ALLOWED_LANGUAGES_FOR_COMPILER_OPTIONS and ENABLE_COMMAND_LINE_ARGUMENTS for controlling usage of compiler options and command line arguments.

Security Improvements

Run compilation process for compiled languages inside sandbox and use values of limit configuration variables for controlling sandbox resources.
Move application location from /usr/src/api to /api to prevent untrusted code from reading it.
- Commits: @0f1b07fe

Other Changes

Don't link math library for C language by default. You now need to send -lm in compiler_options.
- Commits: @619a3bbe

Deployment Procedure

Install Docker and Docker Compose.
Download and extract release archive:

wget https://github.com/judge0/api/releases/download/v1.4.0/judge0-api-v1.4.0.zip
unzip judge0-api-v1.4.0.zip

Run all services and wait few seconds until everything is initialized:

cd judge0-api-v1.4.0
docker-compose up -d
sleep 10s

Your instance of Judge0 API v1.4.0 is now available at http://<IP OF YOUR SERVER>:3000.

v1.3.1 (2019-09-16)

Improvements

Improved handling exec format error by introducing new status Exec Format Error.
- Commits: @93a60115

Bug Fixes

Fixed bug where execution of Go code with no main package would induce execve("./main"): No such file or directory because Go compiler wouldn't create main binary.
- Commits: @93a60115

Deployment Procedure

Install Docker and Docker Compose.
Download and extract release archive:

wget https://github.com/judge0/api/releases/download/v1.3.1/judge0-api-v1.3.1.zip
unzip judge0-api-v1.3.1.zip

Run all services and wait few seconds until everything is initialized:

cd judge0-api-v1.3.1
docker-compose up -d
sleep 10s

Your instance of Judge0 API v1.3.1 is now available at http://<IP OF YOUR SERVER>:3000.

v1.3.0 (2019-09-15)

New Features

Added MAX_QUEUE_SIZE variable that defines a maximum submission queue size. If there is a new submission request and the queue is full, then that submission will be rejected.
- Commits: @a2bcdecb

Improvements

Improved worker shutdown procedure. Workers are now gracefully shutdown on docker stop.
- Commits: @2ae0cd31

Bug Fixes

Fixed a bug where authentication token was auto converted to integer.
- Issues: #101
- Commits: @b92c4970

Deployment Procedure

Install Docker and Docker Compose.
Download and extract release archive:

wget https://github.com/judge0/api/releases/download/v1.3.0/judge0-api-v1.3.0.zip
unzip judge0-api-v1.3.0.zip

Run all services and wait few seconds until everything is initialized:

cd judge0-api-v1.3.0
docker-compose up -d
sleep 10s

Your instance of Judge0 API v1.3.0 is now available at http://<IP OF YOUR SERVER>:3000.

v1.2.2 (2019-09-07)

Securty Fixes

Fixed a bug that allowed anybody to read judge0-api.conf file. This bug was introduced in version v1.2.1 when config was mounted into container. With this fix, config is still mounted into container but not in /usr/src/api folder but rather in /. Root folder is not binded in isolate sandbox, whereas /usr/src/api is.
- Commits: @121c8f9d

Other Changes

Don't allow execution of scripts in /usr/src/api folder.
- Commits: @121c8f9d

Deployment Procedure

Install Docker and Docker Compose.
Download and extract release archive:

wget https://github.com/judge0/api/releases/download/v1.2.2/judge0-api-v1.2.2.zip
unzip judge0-api-v1.2.2.zip

Run all services and wait few seconds until everything is initialized:

cd judge0-api-v1.2.2
docker-compose up -d
sleep 10s

Your instance of Judge0 API v1.2.2 is now available at http://<IP OF YOUR SERVER>:3000.

v1.2.1 (2019-08-24)

Improvements

Improved config loading. Config can now be changed and reload just with docker-compose restart command.
- Commits: @06fc37f1

Bug Fixes

Fixed bug in run-worker script that didn't consider COUNT config variable.
- Issues: #91
- Commits: @06fc37f1

Deployment Procedure

Install Docker and Docker Compose.
Download and extract release archive:

wget https://github.com/judge0/api/releases/download/v1.2.1/judge0-api-v1.2.1.zip
unzip judge0-api-v1.2.1.zip

Run all services and wait few seconds until everything is initialized:

cd judge0-api-v1.2.1
docker-compose up -d
sleep 10s

Your instance of Judge0 API v1.2.1 is now available at http://<IP OF YOUR SERVER>:3000.

v1.2.0-nim0.20.0 (2019-06-26)

This image contains only The Nim Programming Language. Free public instance of this image is available on https://nim.api.judge0.com.

This image was build for the purpose of creating dedicated web playground for this language, and in the future I will add and deploy every new release of it. In the nim branch of Judge0 API Base I will follow and install new releases of Nim, and in the nim branch of Judge0 API I will maintain a Judge0 API that only has Nim available.

Free playground for the Nim programming language that uses Judge0 API is available at https://nim.ide.judge0.com.

Deployment Procedure

Install Docker and Docker Compose.
Download and extract release archive:

wget https://github.com/judge0/api/releases/download/v1.2.0-nim0.20.0/judge0-api-v1.2.0-nim0.20.0.zip
unzip judge0-api-v1.2.0-nim0.20.0.zip

Run all services and wait few seconds until everything is initialized:

cd judge0-api-v1.2.0-nim0.20.0
docker-compose up -d
sleep 10s

Your instance of Judge0 API v1.2.0-nim0.20.0 is now available at http://<IP OF YOUR SERVER>:3000.

v1.2.0-vlang0.1.3 (2019-06-26)

This image contains only The V Programming Language, specifically only V compiler built from commit @b00a47be. Free public instance of this image is available on https://vlang.api.judge0.com.

This image was build for the purpose of creating dedicated web playground for this new programming language, and in the future I will add and deploy every new release of it. In the vlang branch of Judge0 API Base I will follow and install new releases of V, and in the vlang branch of Judge0 API I will maintain a Judge0 API that only has V available.

Free playground for the V programming language that uses Judge0 API is available at https://vlang.ide.judge0.com.

Deployment Procedure

Install Docker and Docker Compose.
Download and extract release archive:

wget https://github.com/judge0/api/releases/download/v1.2.0-vlang0.1.3/judge0-api-v1.2.0-vlang0.1.3.zip
unzip judge0-api-v1.2.0-vlang0.1.3.zip

Run all services and wait few seconds until everything is initialized:

cd judge0-api-v1.2.0-vlang0.1.3
docker-compose up -d
sleep 10s

Your instance of Judge0 API v1.2.0-vlang0.1.3 is now available at http://<IP OF YOUR SERVER>:3000.

v1.2.0 (2019-06-17)

New Features

Added new language Executable that allows executing custom executable files.
- Commits: @0ab08351
Added new configuration variables: REDIS_PASSWORD, REDIS_PORT and POSTGRES_PORT.
- Commits: @962d7d1d

Improvements

Improved run-server and run-worker scripts.
- Commits: @e1b3564b

Bug Fixes

Fixed /etc/apt/sources.list that prevented package update.
- Issues: #84
- Commits: @7fdca3cf
Fixed cleanup bug that didn't remove sandbox files if tmp directory was not empty.
- Commits: @50ee4dbf
Fixed another UTF-8 problem with Python that @nguyenvanquan7826 reported.
- Issues: #69
- Commits: @64635c98

Other Changes

Updated some gems that had security issues.
- Pull Requests: #77 #78 #79 #80 #81 #82
- Commits: @e1b3564b
Prepared Isolate Job for accepting custom compile flags.
- Commits: @4f2dde1f

Deployment Procedure

Install Docker and Docker Compose.
Download and extract release archive:

wget https://github.com/judge0/api/releases/download/v1.2.0/judge0-api-v1.2.0.zip
unzip judge0-api-v1.2.0.zip

Run all services and wait few seconds until everything is initialized:

cd judge0-api-v1.2.0
docker-compose up -d
sleep 10s

Your instance of Judge0 API v1.2.0 is now available at http://<IP OF YOUR SERVER>:3000.

v1.1.5-python3.6.8 (2019-03-08)

On @guvenim request I have built an Judge0 API image that contains just Python 3.6.8. This release also shows what changes are necessary in api-base and api when you only want to use languages that you need.

Deployment Procedure

Install Docker and Docker Compose.
Download and extract release archive:

wget https://github.com/judge0/api/releases/download/v1.1.5-python3.6.8/judge0-api-v1.1.5-python3.6.8.zip
unzip judge0-api-v1.1.5-python3.6.8.zip

Run all services and wait few seconds until everything is initialized:

cd judge0-api-v1.1.5-python3.6.8
docker-compose up -d
sleep 10s

Your instance of Judge0 API v1.1.5-python3.6.8 is now available at http://<IP OF YOUR SERVER>:3000.

v1.1.5 (2019-02-17)

Bug Fixes

Fixed problem with assigning compile output to submission when rerunning submission.
- Commits: @c3cd0232

Other Changes

Remove unwanted newlines from compile output.
- Commits: @c3cd0232

Deployment Procedure

Install Docker and Docker Compose.
Download and extract release archive:

wget https://github.com/judge0/api/releases/download/v1.1.5/judge0-api-v1.1.5.zip
unzip judge0-api-v1.1.5.zip

Run all services and wait few seconds until everything is initialized:

cd judge0-api-v1.1.5
docker-compose up -d
sleep 10s

Your instance of Judge0 API v1.1.5 is now available at http://<IP OF YOUR SERVER>:3000.

v1.1.4 (2019-02-17)

Bug Fixes

Fixed problem with assigning compile output to submission when compile output is not empty.
- Commits: @22403707

Deployment Procedure

Install Docker and Docker Compose.
Download and extract release archive:

wget https://github.com/judge0/api/releases/download/v1.1.4/judge0-api-v1.1.4.zip
unzip judge0-api-v1.1.4.zip

Run all services and wait few seconds until everything is initialized:

cd judge0-api-v1.1.4
docker-compose up -d
sleep 10s

Your instance of Judge0 API v1.1.4 is now available at http://<IP OF YOUR SERVER>:3000.

v1.1.3 (2019-02-15)

Improvements

Improved cleanup of sandbox by deleting stdin, stdout, stderr and meta file before running isolate cleanup.
- Commits: @1dcfaf98

Bug Fixes

Fixed problem with compile output that contained invalid byte sequence in UTF-8.
- Commits: @37d46b14
Fixed problem with submissions not changing their post-run attributes after rerun if compile error occured.
- Commits: @37d46b14

Deployment Procedure

Install Docker and Docker Compose.
Download and extract release archive:

wget https://github.com/judge0/api/releases/download/v1.1.3/judge0-api-v1.1.3.zip
unzip judge0-api-v1.1.3.zip

Run all services and wait few seconds until everything is initialized:

cd judge0-api-v1.1.3
docker-compose up -d
sleep 10s

Your instance of Judge0 API v1.1.3 is now available at http://<IP OF YOUR SERVER>:3000.

v1.1.2 (2019-02-15)

Improvements

Improved reading from stdin and writing to stdout, stderr and meta. They are now not available in sandbox.
- Commits: @1f135c1a @350ff3a4

Bug Fixes

Fixed writing of source code and stdin to disc, they are now written as binary files to avoid UTF-8 problems.
- Commits: @519efbea
Fixed problem with stripping output that contained invalid byte sequence in UTF-8.
- Commits: @4c994c67

Other Changes

Use judge0/api-base:0.3.0 as base image which uses isolate@18554e83.
- Commits: @350ff3a4

Deployment Procedure

Install Docker and Docker Compose.
Download and extract release archive:

wget https://github.com/judge0/api/releases/download/v1.1.2/judge0-api-v1.1.2.zip
unzip judge0-api-v1.1.2.zip

Run all services and wait few seconds until everything is initialized:

cd judge0-api-v1.1.2
docker-compose up -d
sleep 10s

Your instance of Judge0 API v1.1.2 is now available at http://<IP OF YOUR SERVER>:3000.

v1.1.1 (2019-02-13)

Bug Fixes

Fixed a problem when strip method was called on a nil class when expected output was nil.
- Commits: @b25153e9

Other Changes

Don't let worker update submission's finished_at attribute if it already exists. This allows Judge0 API administrators to manually rerun submissions from command line and preserve initial timestamps if some unexpected error occured.
- Commits: @b25153e9

Deployment Procedure

Install Docker and Docker Compose.
Download and extract release archive:

wget https://github.com/judge0/api/releases/download/v1.1.1/judge0-api-v1.1.1.zip
unzip judge0-api-v1.1.1.zip

Run all services and wait few seconds until everything is initialized:

cd judge0-api-v1.1.1
docker-compose up -d
sleep 10s

Your instance of Judge0 API v1.1.1 is now available at http://<IP OF YOUR SERVER>:3000.

v1.1.0 (2019-02-10)

New Features

Added -lm compile flag to link with math library when compiling C source code.
- Pull Requests: #60
Added fixed time limit of 10 seconds for compilation.
- Issues: #63 #64
- Commits: @2f05ce2c

Improvements

Improved procedure of seeding database with languages. Seeding is now idempotent.
- Commits: @72cff961

Bux Fixes

Fixed versions of Postgres and Redis in Docker Compose files.
- Issues: #20 #38 #40 #45 #47 #56 #57
- Commits: @80a61629 @90ec40cf
Fixed problem with workers stopping when they lost connection with Postgres or Redis.
- Commits: @eee340b6
Fixed problem of storing submission's stdout and stderr that contained invalid byte sequence in UTF-8.
- Commits: @ff63c1bc

Deployment Procedure

Install Docker and Docker Compose.
Download and extract release archive:

wget https://github.com/judge0/api/releases/download/v1.1.0/judge0-api-v1.1.0.zip
unzip judge0-api-v1.1.0.zip

Run all services and wait few seconds until everything is initialized:

cd judge0-api-v1.1.0
docker-compose up -d
sleep 10s

v1.0.0 (2017-10-01)

This is the first production ready release of Judge0 API.

Deployment Procedure

Install Docker and Docker Compose.
Download and extract release archive:

wget https://github.com/judge0/api/releases/download/v1.0.0/judge0-api-v1.0.0.zip
unzip judge0-api-v1.0.0.zip

Run all services and wait few seconds until everything is initialized:

cd judge0-api-v1.0.0
docker-compose up -d
sleep 10s

Your instance of Judge0 API v1.0.0 is now available at http://<IP OF YOUR SERVER>:3000.

Files

CHANGELOG.md

Latest commit

History

CHANGELOG.md

File metadata and controls

v1.13.1 (2024-04-18)

Security Fixes

Deployment Procedure

System Requirements

Deployment Steps

v1.13.0 (2021-03-10)

New Features

Bug Fixes

Security Fixes

Other Changes

Deployment Procedure

With HTTP

With HTTPS (SSL/TLS)

v1.12.0 (2020-10-18)

New Features

Improvements

Bug Fixes

Other Changes

Deployment Procedure

With HTTP

With HTTPS (SSL/TLS)

v1.11.0 (2020-09-09)

New Features

Improvements

Other Changes

Deployment Procedure

With HTTP

With HTTPS (SSL/TLS)

v1.10.0 (2020-07-27)

New Features

Other Changes

Deployment Procedure

With HTTPS (SSL/TLS)

With HTTP

v1.9.0 (2020-06-10)

New Features

Other Changes

Deployment Procedure

With HTTPS (SSL/TLS)

With HTTP

v1.8.0 (2020-05-28)

New Features

Bug Fixes

Other Changes

Deployment Procedure

With HTTPS (SSL/TLS)

With HTTP

v1.7.1 (2020-05-06)

Bug Fixes

Other Changes

Deployment Procedure

With HTTPS (SSL/TLS)

With HTTP

v1.7.0 (2020-05-05)

New Features

Other Changes

Deployment Procedure

With HTTPS (SSL/TLS)

With HTTP

v1.6.0 (2020-05-01)

New Features

Improvements

Bug Fixes

Security Fixes

Other Changes

Deployment Procedure

With HTTPS (SSL/TLS)

With HTTP

v1.5.0 (2020-01-01)

New Features

Improvements

Bug Fixes

Other Changes

Deployment Procedure