README.md

Welcome to Nim

Nim is a statically typed, imperative programming language that tries to give the programmer ultimate power without compromises on runtime efficiency. This means it focuses on compile-time mechanisms in all their various forms.

Beneath a nice infix/indentation based syntax with a powerful (AST based, hygienic) macro system lies a semantic model that supports a soft realtime GC on thread local heaps. Asynchronous message passing is used between threads, so no "stop the world" mechanism is necessary. An unsafe shared memory heap is also provided for the increased efficiency that results from that model.

• Official site
• Tutorials
• Documentation
• Report an issue with images

Tags

Tags indicate Nim versions, base images, and flavors. For example, nimlang/nim:2.2.2-ubuntu-regular means Nim version 2.2.2, based on Ubuntu, with Nimble installed. Ubuntu is the default base, so you can omit it in the tag: nimlang/nim:2.2.2-regular. Regular is the default flavor, so you can omit it as well: nimlang/nim:2.2.2. The latest Nim version is additionally tagged as latest: nimlang/nim:latest. And since Docker adds latest automatically, you can just write nimlang/nim.

So, all together:

nimlang/nim = nimlang/nim:latest = nimlang/nim:2.2.2 = nimlang/nim:2.2.2-ubuntu =nimlang/nim:latest-ubuntu = nimlang/nim:2.2.2-regular = nimlang/nim:latest-regular = nimlang/nim:2.2.2-ubuntu-regular = nimlang/nim:latest-ubuntu-regular

Phew, that's one long list! Fortunately, unless you need a specific version of Nim, you'll probably need just nimlang/nim or nimlang/nim:alpine.

Should you want to install a devel branch of the nim compiler or manage multiple nim version we have a nimlang/choosenim image, which provides choosenim. choosenim is a tool designed for managing your nim installation, read more here.

Bases

There are currently two bases for nimlang/nim images: Ubuntu and Alpine. Ubuntu is the default one.

The nimlang/choosenim image is based on bitnami/minideb.

Flavors

nimlang/nim images come in two flavors: slim and regular. Slim images include only the Nim compiler. Regular images include the compiler and Nimble package manager.

Available Tags

• 2.2.2-ubuntu-regular
  • latest, regular, latest-regular, 2.2.2, latest-ubuntu, 2.2.2-ubuntu, ubuntu, latest-ubuntu-regular, 2.2.2-regular
• 2.2.2-ubuntu-slim
  • slim, latest-slim, latest-ubuntu-slim, 2.2.2-slim
• 2.2.2-alpine-regular
  • latest-alpine, 2.2.2-alpine, alpine, latest-alpine-regular
• 2.2.2-alpine-slim
  • latest-alpine-slim
• 2.2.0-ubuntu-regular
  • 2.2.0, 2.2.0-ubuntu, 2.2.0-regular
• 2.2.0-ubuntu-slim
  • 2.2.0-slim
• 2.2.0-alpine-regular
  • 2.2.0-alpine
• 2.2.0-alpine-slim
• 2.0.14-ubuntu-regular
  • 2.0.14, 2.0.14-ubuntu, 2.0.14-regular
• 2.0.14-ubuntu-slim
  • 2.0.14-slim
• 2.0.14-alpine-regular
  • 2.0.14-alpine
• 2.0.14-alpine-slim
• 2.0.12-ubuntu-regular
  • 2.0.12, 2.0.12-ubuntu, 2.0.12-regular
• 2.0.12-ubuntu-slim
  • 2.0.12-slim
• 2.0.12-alpine-regular
  • 2.0.12-alpine
• 2.0.12-alpine-slim
• 2.0.10-ubuntu-regular
  • 2.0.10, 2.0.10-ubuntu, 2.0.10-regular
• 2.0.10-ubuntu-slim
  • 2.0.10-slim
• 2.0.10-alpine-regular
  • 2.0.10-alpine
• 2.0.10-alpine-slim
• 2.0.8-ubuntu-regular
  • 2.0.8, 2.0.8-ubuntu, 2.0.8-regular
• 2.0.8-ubuntu-slim
  • 2.0.8-slim
• 2.0.8-alpine-regular
  • 2.0.8-alpine
• 2.0.8-alpine-slim
• 2.0.6-ubuntu-regular
  • 2.0.6, 2.0.6-ubuntu, 2.0.6-regular
• 2.0.6-ubuntu-slim
  • 2.0.6-slim
• 2.0.6-alpine-regular
  • 2.0.6-alpine
• 2.0.6-alpine-slim
• 2.0.4-ubuntu-regular
  • 2.0.4, 2.0.4-ubuntu, 2.0.4-regular
• 2.0.4-ubuntu-slim
  • 2.0.4-slim
• 2.0.4-alpine-regular
  • 2.0.4-alpine
• 2.0.4-alpine-slim
• 2.0.2-ubuntu-regular
  • 2.0.2, 2.0.2-ubuntu, 2.0.2-regular
• 2.0.2-ubuntu-slim
  • 2.0.2-slim
• 2.0.2-alpine-regular
  • 2.0.2-alpine
• 2.0.2-alpine-slim
• 2.0.0-ubuntu-regular
  • 2.0.0, 2.0.0-ubuntu, 2.0.0-regular
• 2.0.0-ubuntu-slim
  • 2.0.0-slim
• 2.0.0-alpine-regular
  • 2.0.0-alpine
• 2.0.0-alpine-slim
• 1.6.20-ubuntu-regular
  • 1.6.20, 1.6.20-ubuntu, 1.6.20-regular
• 1.6.20-ubuntu-slim
  • 1.6.20-slim
• 1.6.20-alpine-regular
  • 1.6.20-alpine
• 1.6.20-alpine-slim
• 1.6.18-ubuntu-regular
  • 1.6.18, 1.6.18-ubuntu, 1.6.18-regular
• 1.6.18-ubuntu-slim
  • 1.6.18-slim
• 1.6.18-alpine-regular
  • 1.6.18-alpine
• 1.6.18-alpine-slim
• 1.6.16-ubuntu-regular
  • 1.6.16, 1.6.16-ubuntu, 1.6.16-regular
• 1.6.16-ubuntu-slim
  • 1.6.16-slim
• 1.6.16-alpine-regular
  • 1.6.16-alpine
• 1.6.16-alpine-slim
• 1.6.14-ubuntu-regular
  • 1.6.14, 1.6.14-ubuntu, 1.6.14-regular
• 1.6.14-ubuntu-slim
  • 1.6.14-slim
• 1.6.14-alpine-regular
  • 1.6.14-alpine
• 1.6.14-alpine-slim
• 1.6.12-ubuntu-regular
  • 1.6.12, 1.6.12-ubuntu, 1.6.12-regular
• 1.6.12-ubuntu-slim
  • 1.6.12-slim
• 1.6.12-alpine-regular
  • 1.6.12-alpine
• 1.6.12-alpine-slim
• 1.6.10-ubuntu-regular
  • 1.6.10, 1.6.10-ubuntu, 1.6.10-regular
• 1.6.10-ubuntu-slim
  • 1.6.10-slim
• 1.6.10-alpine-regular
  • 1.6.10-alpine
• 1.6.10-alpine-slim
• 1.6.8-ubuntu-regular
  • 1.6.8, 1.6.8-ubuntu, 1.6.8-regular
• 1.6.8-ubuntu-slim
  • 1.6.8-slim
• 1.6.8-alpine-regular
  • 1.6.8-alpine
• 1.6.8-alpine-slim
• 1.6.6-ubuntu-regular
  • 1.6.6, 1.6.6-ubuntu, 1.6.6-regular
• 1.6.6-ubuntu-slim
  • 1.6.6-slim
• 1.6.6-alpine-regular
  • 1.6.6-alpine
• 1.6.6-alpine-slim
• 1.6.4-ubuntu-regular
  • 1.6.4, 1.6.4-ubuntu, 1.6.4-regular
• 1.6.4-ubuntu-slim
  • 1.6.4-slim
• 1.6.4-alpine-regular
  • 1.6.4-alpine
• 1.6.4-alpine-slim
• 1.6.2-ubuntu-regular
  • 1.6.2, 1.6.2-ubuntu, 1.6.2-regular
• 1.6.2-ubuntu-slim
  • 1.6.2-slim
• 1.6.2-alpine-regular
  • 1.6.2-alpine
• 1.6.2-alpine-slim
• 1.6.0-ubuntu-regular
  • 1.6.0, 1.6.0-ubuntu, 1.6.0-regular
• 1.6.0-ubuntu-slim
  • 1.6.0-slim
• 1.6.0-alpine-regular
  • 1.6.0-alpine
• 1.6.0-alpine-slim
• 1.4.8-ubuntu-regular
  • 1.4.8, 1.4.8-ubuntu, 1.4.8-regular
• 1.4.8-ubuntu-slim
  • 1.4.8-slim
• 1.4.8-alpine-regular
  • 1.4.8-alpine
• 1.4.8-alpine-slim
• 1.4.6-ubuntu-regular
  • 1.4.6, 1.4.6-ubuntu, 1.4.6-regular
• 1.4.6-ubuntu-slim
  • 1.4.6-slim
• 1.4.6-alpine-regular
  • 1.4.6-alpine
• 1.4.6-alpine-slim
• 1.4.4-ubuntu-regular
  • 1.4.4, 1.4.4-ubuntu, 1.4.4-regular
• 1.4.4-ubuntu-slim
  • 1.4.4-slim
• 1.4.4-alpine-regular
  • 1.4.4-alpine
• 1.4.4-alpine-slim
• 1.4.2-ubuntu-regular
  • 1.4.2, 1.4.2-ubuntu, 1.4.2-regular
• 1.4.2-ubuntu-slim
  • 1.4.2-slim
• 1.4.2-alpine-regular
  • 1.4.2-alpine
• 1.4.2-alpine-slim
• 1.4.0-ubuntu-regular
  • 1.4.0, 1.4.0-ubuntu, 1.4.0-regular
• 1.4.0-ubuntu-slim
  • 1.4.0-slim
• 1.4.0-alpine-regular
  • 1.4.0-alpine
• 1.4.0-alpine-slim
• 1.2.12-ubuntu-regular
  • 1.2.12, 1.2.12-ubuntu, 1.2.12-regular
• 1.2.12-ubuntu-slim
  • 1.2.12-slim
• 1.2.12-alpine-regular
  • 1.2.12-alpine
• 1.2.12-alpine-slim
• 1.2.8-ubuntu-regular
  • 1.2.8, 1.2.8-ubuntu, 1.2.8-regular
• 1.2.8-ubuntu-slim
  • 1.2.8-slim
• 1.2.8-alpine-regular
  • 1.2.8-alpine
• 1.2.8-alpine-slim
• 1.2.6-ubuntu-regular
  • 1.2.6, 1.2.6-ubuntu, 1.2.6-regular
• 1.2.6-ubuntu-slim
  • 1.2.6-slim
• 1.2.6-alpine-regular
  • 1.2.6-alpine
• 1.2.6-alpine-slim
• 1.2.4-ubuntu-regular
  • 1.2.4, 1.2.4-ubuntu, 1.2.4-regular
• 1.2.4-ubuntu-slim
  • 1.2.4-slim
• 1.2.4-alpine-regular
  • 1.2.4-alpine
• 1.2.4-alpine-slim
• 1.2.2-ubuntu-regular
  • 1.2.2, 1.2.2-ubuntu, 1.2.2-regular
• 1.2.2-ubuntu-slim
  • 1.2.2-slim
• 1.2.2-alpine-regular
  • 1.2.2-alpine
• 1.2.2-alpine-slim
• 1.2.0-ubuntu-regular
  • 1.2.0, 1.2.0-ubuntu, 1.2.0-regular
• 1.2.0-ubuntu-slim
  • 1.2.0-slim
• 1.2.0-alpine-regular
  • 1.2.0-alpine
• 1.2.0-alpine-slim
• 1.0.10-ubuntu-regular
  • 1.0.10, 1.0.10-ubuntu, 1.0.10-regular
• 1.0.10-ubuntu-slim
  • 1.0.10-slim
• 1.0.10-alpine-regular
  • 1.0.10-alpine
• 1.0.10-alpine-slim
• 1.0.8-ubuntu-regular
  • 1.0.8, 1.0.8-ubuntu, 1.0.8-regular
• 1.0.8-ubuntu-slim
  • 1.0.8-slim
• 1.0.8-alpine-regular
  • 1.0.8-alpine
• 1.0.8-alpine-slim
• 1.0.6-ubuntu-regular
  • 1.0.6, 1.0.6-ubuntu, 1.0.6-regular
• 1.0.6-ubuntu-slim
  • 1.0.6-slim
• 1.0.6-alpine-regular
  • 1.0.6-alpine
• 1.0.6-alpine-slim
• 1.0.4-ubuntu-regular
  • 1.0.4, 1.0.4-ubuntu, 1.0.4-regular
• 1.0.4-ubuntu-slim
  • 1.0.4-slim
• 1.0.4-alpine-regular
  • 1.0.4-alpine
• 1.0.4-alpine-slim
• 1.0.2-ubuntu-regular
  • 1.0.2, 1.0.2-ubuntu, 1.0.2-regular
• 1.0.2-ubuntu-slim
  • 1.0.2-slim
• 1.0.2-alpine-regular
  • 1.0.2-alpine
• 1.0.2-alpine-slim
• 1.0.0-ubuntu-regular
  • 1.0.0, 1.0.0-ubuntu, 1.0.0-regular
• 1.0.0-ubuntu-slim
  • 1.0.0-slim
• 1.0.0-alpine-regular
  • 1.0.0-alpine
• 1.0.0-alpine-slim
• 0.20.2-ubuntu-regular
  • 0.20.2, 0.20.2-ubuntu, 0.20.2-regular
• 0.20.2-ubuntu-slim
  • 0.20.2-slim
• 0.20.2-alpine-regular
  • 0.20.2-alpine
• 0.20.2-alpine-slim
• 0.20.0-ubuntu-regular
  • 0.20.0, 0.20.0-ubuntu, 0.20.0-regular
• 0.20.0-ubuntu-slim
  • 0.20.0-slim
• 0.20.0-alpine-regular
  • 0.20.0-alpine
• 0.20.0-alpine-slim
• 0.19.6-ubuntu-regular
  • 0.19.6, 0.19.6-ubuntu, 0.19.6-regular
• 0.19.6-ubuntu-slim
  • 0.19.6-slim
• 0.19.6-alpine-regular
  • 0.19.6-alpine
• 0.19.6-alpine-slim
• 0.19.4-ubuntu-regular
  • 0.19.4, 0.19.4-ubuntu, 0.19.4-regular
• 0.19.4-ubuntu-slim
  • 0.19.4-slim
• 0.19.4-alpine-regular
  • 0.19.4-alpine
• 0.19.4-alpine-slim
• 0.19.2-ubuntu-regular
  • 0.19.2, 0.19.2-ubuntu, 0.19.2-regular
• 0.19.2-ubuntu-slim
  • 0.19.2-slim
• 0.19.2-alpine-regular
  • 0.19.2-alpine
• 0.19.2-alpine-slim
• 0.19.0-ubuntu-regular
  • 0.19.0, 0.19.0-ubuntu, 0.19.0-regular
• 0.19.0-ubuntu-slim
  • 0.19.0-slim
• 0.19.0-alpine-regular
  • 0.19.0-alpine
• 0.19.0-alpine-slim
• 0.18.0-ubuntu-regular
  • 0.18.0, 0.18.0-ubuntu, 0.18.0-regular
• 0.18.0-ubuntu-slim
  • 0.18.0-slim
• 0.18.0-alpine-regular
  • 0.18.0-alpine
• 0.18.0-alpine-slim
• 0.17.2-ubuntu-regular
  • 0.17.2, 0.17.2-ubuntu, 0.17.2-regular
• 0.17.2-ubuntu-slim
  • 0.17.2-slim
• 0.17.2-alpine-regular
  • 0.17.2-alpine
• 0.17.2-alpine-slim
• 0.17.0-ubuntu-regular
  • 0.17.0, 0.17.0-ubuntu, 0.17.0-regular
• 0.17.0-ubuntu-slim
  • 0.17.0-slim
• 0.17.0-alpine-regular
  • 0.17.0-alpine
• 0.17.0-alpine-slim
• 0.16.0-ubuntu-regular
  • 0.16.0, 0.16.0-ubuntu, 0.16.0-regular
• 0.16.0-ubuntu-slim
  • 0.16.0-slim
• 0.16.0-alpine-regular
  • 0.16.0-alpine
• 0.16.0-alpine-slim
• 0.15.2-ubuntu-regular
  • 0.15.2, 0.15.2-ubuntu, 0.15.2-regular
• 0.15.2-ubuntu-slim
  • 0.15.2-slim
• 0.15.2-alpine-regular
  • 0.15.2-alpine
• 0.15.2-alpine-slim
• 0.15.0-ubuntu-regular
  • 0.15.0, 0.15.0-ubuntu, 0.15.0-regular
• 0.15.0-ubuntu-slim
  • 0.15.0-slim
• 0.15.0-alpine-regular
  • 0.15.0-alpine
• 0.15.0-alpine-slim
• 0.14.3-ubuntu-regular
  • 0.14.3, 0.14.3-ubuntu, 0.14.3-regular
• 0.14.3-ubuntu-slim
  • 0.14.3-slim
• 0.14.3-alpine-regular
  • 0.14.3-alpine
• 0.14.3-alpine-slim
• 0.14.2-ubuntu-regular
  • 0.14.2, 0.14.2-ubuntu, 0.14.2-regular
• 0.14.2-ubuntu-slim
  • 0.14.2-slim
• 0.14.2-alpine-regular
  • 0.14.2-alpine
• 0.14.2-alpine-slim
• 0.14.0-ubuntu-regular
  • 0.14.0, 0.14.0-ubuntu, 0.14.0-regular
• 0.14.0-ubuntu-slim
  • 0.14.0-slim
• 0.14.0-alpine-regular
  • 0.14.0-alpine
• 0.14.0-alpine-slim
• 0.13.0-ubuntu-regular
  • 0.13.0, 0.13.0-ubuntu, 0.13.0-regular
• 0.13.0-ubuntu-slim
  • 0.13.0-slim
• 0.13.0-alpine-regular
  • 0.13.0-alpine
• 0.13.0-alpine-slim

Build Status

• 
• 
• 
• 
• 
• 
• 
• 

Using the Images

Get the Latest Version

$ docker pull nimlang/nim

$ docker pull nimlang/choosenim

Compiling a Single File

$ docker run --rm -v `pwd`:/usr/src/app -w /usr/src/app nimlang/nim nim c -r myapp.nim

Compiling a Static Single File

$ docker run --rm -v `pwd`:/usr/src/app -w /usr/src/app nimlang/nim:alpine nim c --passL:"-static -no-pie" myapp.nim