Judge0 API Base is an base API Docker image with installed compilers, interpreters and sandbox environment - isolate.
Each compiler and interpreter is compiled during image build, or if precompiled binary was available for x86_64 architecture then this binary is used.
We used this approach of compiling each compiler and interpreter instead of installing available packages because we have full control of choosing where this compiler and interpreter will be installed. That also gives us ability to install some compilers and interpreters that are not available with package manager.
As a consequence, Judge0 API Base image is large (8.82 GB uncompressed) and build time takes few hours, but we successfully installed more than 40 different compilers and interpreters and more of them can be added easily.
We are open to any suggestions on how to reduce size of this image but retain flexibility of adding/removing new compilers and interpreters.
Here is a list of supported languages:
| # | Name |
|---|---|
| 1 | Bash (4.4) |
| 2 | Bash (4.0) |
| 3 | Basic (fbc 1.05.0) |
| 4 | C (gcc 7.2.0) |
| 5 | C (gcc 6.4.0) |
| 6 | C (gcc 6.3.0) |
| 7 | C (gcc 5.4.0) |
| 8 | C (gcc 4.9.4) |
| 9 | C (gcc 4.8.5) |
| 10 | C++ (g++ 7.2.0) |
| 11 | C++ (g++ 6.4.0) |
| 12 | C++ (g++ 6.3.0) |
| 13 | C++ (g++ 5.4.0) |
| 14 | C++ (g++ 4.9.4) |
| 15 | C++ (g++ 4.8.5) |
| 16 | C# (mono 5.4.0.167) |
| 17 | C# (mono 5.2.0.224) |
| 18 | Clojure (1.8.0) |
| 19 | Crystal (0.23.1) |
| 20 | Elixir (1.5.1) |
| 21 | Erlang (OTP 20.0) |
| 22 | Go (1.9) |
| 23 | Haskell (ghc 8.2.1) |
| 24 | Haskell (ghc 8.0.2) |
| 25 | Insect (5.0.0) |
| 26 | Java (OpenJDK 9) |
| 27 | Java (OpenJDK 8) |
| 28 | Java (OpenJDK 7) |
| 29 | JavaScript (nodejs 8.5.0) |
| 30 | JavaScript (nodejs 7.10.1) |
| 31 | OCaml (4.05.0) |
| 32 | Octave (4.2.0) |
| 33 | Pascal (fpc 3.0.0) |
| 34 | Python (3.6.0) |
| 35 | Python (3.5.3) |
| 36 | Python (2.7.9) |
| 37 | Python (2.6.9) |
| 38 | Ruby (2.4.0) |
| 39 | Ruby (2.3.3) |
| 40 | Ruby (2.2.6) |
| 41 | Ruby (2.1.9) |
| 42 | Rust (1.20.0) |
| 43 | Text (plain text) |
Sandbox environment is also included in this image. For sandbox environment we are using isolate (licensed under GPL v2).
Isolate is a sandbox built to safely run untrusted executables, offering them a limited-access environment and preventing them from affecting the host system. It takes advantage of features specific to the Linux kernel, like namespaces and control groups.
Huge thanks to Martin Mareš and Bernard Blackham for developing and maintaining this project. Also, thanks to all other people who contributed to isolate project.
Isolate was used as sandbox environment (part of CMS system) on big programming contests like International Olympiad in Informatics (a.k.a. IOI) in 2012, and we trust that this sandbox environment works and does its job.
If you want to build your own Judge0 API Base image:
- Clone or download this project.
- Make changes if you want.
- Run
docker build -t yourRepoName . - Grab some coffee, this will take some time.
Take a look at Docker Hub. There are version tags and latest tag.
latest tag will always be equal to highest version tag. Dockerfiles for all versions will be available in tags or releases pages of GitHub.
To pull version 0.3.0:
docker pull judge0/api-base:0.3.0- Grab some coffee, this might take a while.
Adding new compiler or interpreter is easy as long as you know how to compile it properly or as long as you know what precompiled binary you need to download.
You should add installation of your favorite compiler between installation of last compiler and isolate installation. Installation of isolate should always be the last, because it is then easier to rebuild image when new version of isolate is available.
You should also install your favorite compiler inside /usr/local/ folder. For example gcc v6.3.0 is installed inside /usr/local/gcc-6.3.0 folder.
Please note that when you add new compiler or interpreter there is still some work that needs to be done for it to be usable on Judge0 API, but adding it to Judge0 API Base image is the first step. After that read documentation of Judge0 API for the next steps.
If you like Judge0, please consider making a donation to support this project.