nim Docker official image overview

⁠Quick reference

• Maintained by:
  Nim Core Team⁠

• Where to get help:
  the Docker Community Slack⁠, Server Fault⁠, Unix & Linux⁠, or Stack Overflow⁠

⁠Supported tags and respective Dockerfile links

• 2.2.10, 2.2, 2, latest⁠

• 2.2.8⁠

• 2.2.6⁠

• 2.2.4⁠

• 2.2.2⁠

• 2.2.0⁠

• 2.0.14, 2.0⁠

• 2.0.12⁠

• 2.0.10⁠

• 2.0.8⁠

• 2.0.6⁠

• 2.0.4⁠

• 2.0.2⁠

• 2.0.0⁠

⁠Quick reference (cont.)

• Where to file issues:
  https://github.com/nim-lang/docker-images/issues⁠

• Supported architectures: (more info⁠)
  amd64⁠, arm32v7⁠, arm64v8⁠, i386⁠

• Published image artifact details:
  repo-info repo's repos/nim/ directory⁠ (history⁠)
  (image metadata, transfer size, etc)

• Image updates:
  official-images repo's library/nim label⁠
  official-images repo's library/nim file⁠ (history⁠)

• Source of this description:
  docs repo's nim/ directory⁠ (history⁠)

⁠What is Nim?

Nim⁠ is a statically typed, imperative programming language that focuses on efficiency, expressiveness, and elegance. It is designed to be as fast as C and as readable as Python, while offering a powerful macro system for metaprogramming.

⁠How to use this image

⁠Compile and run a Nim program (C backend)

To compile a file named main.nim and execute it immediately:

$ docker run --rm -v "$PWD":/usr/src/app -w /usr/src/app nim nim c -r main.nim

⁠Compile to JavaScript

Nim can compile to JavaScript:

$ docker run --rm -v "$PWD":/usr/src/app -w /usr/src/app nim nim js main.nim

To compile and run, use a multi-stage Dockerfile with Node.js:

FROM nim AS builder
COPY . .
RUN nim js -o:app.js src/app.nim

FROM node:latest
COPY --from=builder /usr/src/app/app.js .
CMD ["node", "app.js"]

⁠Managing packages with Nimble

The image is configured with SSL support to allow Nimble to install packages from remote repositories:

$ docker run --rm -v "$PWD":/usr/src/app -w /usr/src/app nim nimble install -y

⁠Dockerfile example

FROM nim

WORKDIR /usr/src/app

COPY *.nimble .
RUN nimble install --depsOnly -y

COPY . .
RUN nimble build

CMD ["./yourapp"]

⁠License

View license information⁠ for the software contained in this image.

As with all Docker images, these likely also contain other software which may be under other licenses (such as Bash, etc from the base distribution, along with any direct or indirect dependencies of the primary software being contained).

Some additional license information which was able to be auto-detected might be found in the repo-info repository's nim/ directory⁠.

As for any pre-built image usage, it is the image user's responsibility to ensure that any use of this image complies with any relevant licenses for all software contained within.