ht-docker-tools/readme.md

ht-docker-tools

Docker images for various tools (MongoDB, MinIO, ClickHouse, Caddy, Redis) enhanced with Deno runtime support.

Available Images

Official Base Images

These images extend official Docker images with Deno runtime:

Image	Base	Description
ht-docker-tools:clickhouse	clickhouse/clickhouse-server	ClickHouse + Deno
ht-docker-tools:mongodb	mongo:latest	MongoDB + Deno
ht-docker-tools:minio	minio/minio:latest	MinIO + Deno
ht-docker-tools:caddy	caddy:latest	Caddy + Deno
ht-docker-tools:redis	redis:latest	Redis + Deno

Alpine Images

Lightweight Alpine-based images with full NVM + Node.js + Deno support:

Image	Description	Size
ht-docker-tools:clickhouse-alpine	ClickHouse + NVM + Node.js + Deno	~250MB
ht-docker-tools:mongodb-alpine	MongoDB + NVM + Node.js + Deno	~200MB
ht-docker-tools:minio-alpine	MinIO + NVM + Node.js + Deno	~200MB
ht-docker-tools:caddy-alpine	Caddy + NVM + Node.js + Deno	~200MB
ht-docker-tools:redis-alpine	Redis + NVM + Node.js + Deno	~200MB

Quick Start

Using Official Base Images

# MongoDB with Deno scripting
docker run -d --name mongo ht-docker-tools:mongodb

# Execute Deno script inside container
docker exec mongo deno run --allow-net script.ts

# Redis with Deno
docker run -d --name redis ht-docker-tools:redis

Using Alpine Images

# MongoDB Alpine with Node.js and Deno
docker run -d --name mongo-alpine ht-docker-tools:mongodb-alpine

# Use Node.js
docker exec mongo-alpine bash -c "node --version"

# Use Deno
docker exec mongo-alpine bash -c "deno --version"

# Switch Node versions with NVM
docker exec mongo-alpine bash -c "nvm install 18 && nvm use 18 && node --version"

Features

Official Base Images

• Extend official Docker images (MongoDB, MinIO, ClickHouse, Caddy, Redis)
• Add Deno runtime for scripting and automation
• Preserve original image entrypoints and configurations
• Ideal for production use with existing configurations

Alpine Images

• Lightweight Alpine-based (significantly smaller than official images)
• Full NVM support for Node.js version switching
• Node.js LTS (20.18.2) pre-installed
• Deno runtime included
• Multi-architecture support (amd64/arm64)
• Ideal for CI/CD and development environments

Docker Compose Example

version: '3.8'

services:
  mongodb:
    image: code.foss.global/host.today/ht-docker-tools:mongodb-alpine
    ports:
      - "27017:27017"
    volumes:
      - mongodb_data:/data/db
    command: mongod

  redis:
    image: code.foss.global/host.today/ht-docker-tools:redis-alpine
    ports:
      - "6379:6379"
    volumes:
      - redis_data:/data
    command: redis-server

  minio:
    image: code.foss.global/host.today/ht-docker-tools:minio-alpine
    ports:
      - "9000:9000"
      - "9001:9001"
    environment:
      MINIO_ROOT_USER: minioadmin
      MINIO_ROOT_PASSWORD: minioadmin
    volumes:
      - minio_data:/data
    command: minio server /data --console-address ":9001"

  caddy:
    image: code.foss.global/host.today/ht-docker-tools:caddy-alpine
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./Caddyfile:/etc/caddy/Caddyfile
      - caddy_data:/data
      - caddy_config:/config

volumes:
  mongodb_data:
  redis_data:
  minio_data:
  caddy_data:
  caddy_config:

Building Images Locally

# Clone the repository
git clone https://code.foss.global/host.today/ht-docker-tools.git
cd ht-docker-tools

# Build all images
chmod +x build-images.sh
./build-images.sh

# Test all images
chmod +x test-images.sh
./test-images.sh

Multi-Architecture Support

All Alpine images support both linux/amd64 and linux/arm64 architectures.

For CI/CD multi-arch builds:

docker buildx build \
  --platform linux/amd64,linux/arm64 \
  -f Dockerfile_mongodb_alpine \
  -t code.foss.global/host.today/ht-docker-tools:mongodb-alpine \
  --push .

NVM Usage (Alpine Images)

Alpine images include NVM for Node.js version management:

# Check NVM version
docker run --rm ht-docker-tools:redis-alpine bash -c "nvm --version"

# Install specific Node.js version
docker run --rm ht-docker-tools:redis-alpine bash -c "nvm install 18 && node --version"

# Use in Dockerfile
FROM code.foss.global/host.today/ht-docker-tools:mongodb-alpine
RUN nvm install 18 && nvm use 18 && npm install -g typescript

Registry

Images are available at:

• code.foss.global/host.today/ht-docker-tools

License

MIT - Task Venture Capital GmbH