nimlang/nim repository overview

WARNING This is a legacy community account kept to compatibility. Nim now has official Docker images: https://hub.docker.com/_/nim⁠.

The official images are easier to install, support more platforms, and offer better support from Docker Hub. Use them instead of these legacy images!

⁠Nim Programming Language Official Docker Images

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.

These images provide a stable, multi-architecture environment for developing and deploying Nim applications.

⁠Key Features

• Multi-Backend Support: Includes the necessary toolchains for C, C++, and JavaScript compilation.
• Precompiled Binaries: Built using official Nim binaries for maximum reliability and consistency with the upstream releases.
• Multi-Arch: Native support for amd64, arm64, and armv7 via Docker manifests.

⁠How to Use This Image

⁠Compile and Run (C Backend)

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

docker run --rm -v "$(pwd)":/usr/src/app nimlang/nim:latest nim c -r main.nim

⁠Compile to JavaScript

Since Nim compiles to JS, this image includes Node.js to serve as the runtime for your scripts:

docker run --rm -v "$(pwd)":/usr/src/app your-repo/nim:latest nim js -r main.nim

⁠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 your-repo/nim:latest nimble install -y

⁠Understanding the Tags

We use a "floating" tag strategy based on Semantic Versioning. This allows you to choose between absolute pinning or automatic updates for patches and minor versions.

• latest: Points to the most recent stable release.
• 2: Points to the latest stable release in the 2.x.x series.
• 2.2: Points to the latest stable release in the 2.2.x series.
• 2.2.8: An immutable tag for a specific version.

⁠Supported Architectures

This image is a manifest list. Docker will automatically pull the correct layer for your CPU:

• linux/amd64
• linux/arm64 (e.g., Apple Silicon, AWS Graviton)
• linux/arm/v7 (e.g., Raspberry Pi 3/4)

⁠Maintenance

This repository is automatically updated via GitHub Actions. If you encounter any issues with the image structure or toolchain, please report them at https://github.com/nim-lang/docker-images/⁠