amd64/nim repository overview

Note: this is the "per-architecture" repository for the amd64 builds of the nim official image⁠ -- for more information, see "Architectures other than amd64?" in the official images documentation⁠ and "An image's source changed in Git, now what?" in the official images FAQ⁠.

⁠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.12, 2.2, 2, latest⁠

• 2.0.14, 2.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 amd64/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 amd64/nim nim js main.nim

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

FROM amd64/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 amd64/nim nimble install -y

⁠Dockerfile example

FROM amd64/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.