ht-docker-node/changelog.md

# Changelog

## 2025-10-26 - 5.1.0 - feat(alpine-deno)
Improve alpine deno image: switch to alpine:edge and use native Deno package, remove glibc workaround, update NVM/PATH, add local tooling settings and expanded README

- Dockerfile_alpine_deno: switch base image from alpine:latest to alpine:edge to use Alpine community Deno package
- Install Deno via apk (native musl build) and remove previous glibc installation/workaround
- Remove DENO_INSTALL env and adjust PATH to include NVM-managed Node binary path
- Keep NVM installation and make nvm available globally; set NODE_VERSION_LTS and default alias
- Add .claude/settings.local.json with local permissions for build/run tooling
- Add / expand README (readme.md) with usage, flavours and NVM/npmci guidance

## 2025-10-26 - 5.0.148 - feat(alpine)
Major restructuring: Multi-architecture Alpine Docker images with modern runtime support

**Breaking Changes:**
- Removed `Dockerfile_alpine` (replaced by `Dockerfile_alpine_node`)
- Removed `Dockerfile_iot` (no longer needed with multi-arch approach)
- Tag naming simplified: `:alpine-node` instead of `:alpine-x64-node` and `:alpine-arm64-node`

**New Multi-Architecture Alpine Images (3 variants):**

All images support both amd64 and arm64 architectures natively:
- `Dockerfile_alpine_node` → `:alpine-node` - Alpine with Node.js LTS + NVM + pnpm
- `Dockerfile_alpine_deno` → `:alpine-deno` - Alpine with Node.js LTS + NVM + Deno
- `Dockerfile_alpine_bun` → `:alpine-bun` - Alpine with Node.js LTS + NVM + Bun

**Technical Improvements:**
- **Multi-architecture support**: Single Docker image works natively on both x64 (AMD64) and ARM64 (Apple Silicon, ARM servers)
- **docker buildx integration**: Build script uses buildx for proper multi-platform image creation
- **Native performance**: No emulation needed - images run at full native speed on both architectures
- **Automatic platform selection**: Docker automatically pulls the correct architecture variant
- Full NVM support in all Alpine images (v0.40.1)
- Node.js musl builds from unofficial-builds.nodejs.org for Alpine compatibility
- Significantly smaller image sizes (200-300MB vs 800MB+ Ubuntu)
- All images include NVM for flexible version management
- Reused wrapper scripts from Ubuntu base for consistency
- Added Bun and Deno runtime support

**Build & Test Infrastructure:**
- Updated `build-alpine-images.sh` to use `docker buildx` with native platform builds for local testing
- Updated `test-alpine-images.sh` to test 3 multi-arch images instead of 9 architecture-specific images
- Simplified test suite focuses on runtime functionality and NVM version switching

**Documentation:**
- Updated README with multi-architecture approach explanation
- Simplified examples using new tag names (`:alpine-node`, `:alpine-deno`, `:alpine-bun`)
- Added cross-platform development examples
- Documented native performance benefits
- Removed architecture-specific instructions (no longer needed)

## 2025-10-26 - 5.0.147 - feat(nvm)
Enable full nvm support in Docker builds and CI/CD workflows

- Added global nvm configuration in /etc/bash.bashrc (prepended before interactive check)
- Created bash-with-nvm wrapper for Dockerfile RUN commands
- Added intelligent ENTRYPOINT for runtime nvm support
- nvm commands now work directly in Dockerfile RUN without manual sourcing
- nvm commands work in CI/CD workflow bash -c scripts automatically
- Changed default SHELL directive to use nvm wrapper
- Backward compatible: npmci still available, ENV PATH preserved for fallback
- Non-bash shells fall back to ENV PATH (v20.12.2)
- Both interactive and non-interactive shells have full nvm access

## 2024-11-17 - 5.0.146 - fix(Dockerfiles)
Correct Docker image source host in various Dockerfiles

- Updated the source host from 'hosttoday/ht-docker-node' to 'host.today/ht-docker-node' in several Dockerfiles

## 2024-11-17 - 5.0.145 - fix(docs)
Minor documentation updates without code changes.


## 2024-11-17 - 5.0.144 - fix(ci)
Update Docker container source for workflow to new registry

- Changed Docker container image source in .gitea/workflows/docker_tags.yaml to code.foss.global.

## 2024-11-17 - 5.0.143 - fix(core)
No uncommitted changes

- No changes detected. All files are up-to-date.

## 2024-05-26 - 5.0.139 to 5.0.142 - Core updates
Routine updates to the core functionality.

## 2024-05-23 - 5.0.124 to 5.0.138 - Core updates
Routine updates to the core functionality.

## 2024-04-23 - 5.0.114 to 5.0.123 - Core updates
Routine updates to the core functionality.

## 2024-04-14 - 5.0.113 to 5.0.113 - Core updates
Routine updates to the core functionality.

## 2023-04-02 - 5.0.105 to 5.0.112 - Core updates
Routine updates to the core functionality.

## 2022-12-17 - 5.0.101 to 5.0.104 - Core updates
Routine updates to the core functionality.

## 2022-10-17 - 5.0.91 to 5.0.100 - Core updates
Routine updates to the core functionality.

## 2022-10-11 - 5.0.85 to 5.0.90 - Core updates
Routine updates to the core functionality.

## 2022-08-05 - 5.0.78 to 5.0.84 - Core updates
Routine updates to the core functionality.

## 2022-03-22 - 5.0.75 to 5.0.77 - Core updates
Routine updates to the core functionality.

## 2021-11-12 - 5.0.67 to 5.0.74 - Core updates
Routine updates to the core functionality.

## 2021-10-22 - 5.0.61 to 5.0.66 - Core updates
Routine updates to the core functionality.

## 2020-05-28 - 5.0.55 to 5.0.60 - Core updates
Routine updates to the core functionality.

## 2019-11-19 - 5.0.50 to 5.0.54 - Core and Snyk fixes
Core updates and restored Snyk to the latest version.

## 2016-08-31 - 4.3.2 to 4.3.5 - Core updates
Routine updates to the core functionality.

## 2016-06-01 - 4.3.1 - Multiple enhancements
Implemented various features and fixes in the project.

- Updated .gitlab-ci.yml multiple times
- Added Python3 support
- Added new features and fixed various issues