Helix Docker Build Environment

This project provides a Docker image for a Rust + Python 3.9 cross-compilation and tooling environment.

Files

• Dockerfile: image definition.
• build-rootless-image.sh: rootless build script (no daily sudo).

One-Time Host Setup

Install rootless Docker prerequisite:

sudo apt-get update
sudo apt-get install -y uidmap

Build Image (No Sudo)

cd /home/helix/HelixDrive
./build-rootless-image.sh

Custom tag:

./build-rootless-image.sh my-image:dev

View Detailed Build Progress

The script now uses plain progress output by default:

docker build --progress=plain ...

So each build step prints full logs instead of condensed progress bars.

Current Rootless Docker User Config

Registry/DNS config file:

• ~/.config/docker/daemon.json

Apply config changes with:

systemctl --user daemon-reload
systemctl --user restart docker

Run Container

docker run --rm -it helix-dev-env:latest

Mount workspace:

docker run --rm -it \
  -v /home/helix/HelixDrive:/workspace \
  helix-dev-env:latest

Run StrictDoc Server

If you want to open StrictDoc from the host browser, you must do both:

• publish the container port with -p 5111:5111
• make StrictDoc listen on 0.0.0.0 instead of container-local 127.0.0.1

Start the container:

docker run --rm -it \
  -p 5111:5111 \
  -v /home/helix/HelixDrive:/workspace \
  helix-dev-env:latest

Inside the container:

cd /workspace/PROJCLI/strictdoc-templates
strictdoc server . --host 0.0.0.0 --port 5111

Then open:

http://127.0.0.1:5111/

Quick Troubleshooting

• If script reports uidmap missing, install it from the one-time setup section.
• If network pull fails, check rootless daemon status with systemctl --user status docker.
• If you update ~/.config/docker/daemon.json, restart rootless docker service before rebuilding.
• If a service works inside the container but cannot be opened from the host, check both the Docker -p host:container mapping and whether the service is listening on 0.0.0.0 instead of 127.0.0.1.