ragedunicorn/luacheck repository overview

⁠Luacheck Alpine Docker Image

A lightweight Luacheck build on Alpine Linux for fast and efficient Lua code linting and static analysis.

⁠Quick Start

# Pull latest version
docker pull ragedunicorn/luacheck:latest

# Or pull specific version
docker pull ragedunicorn/luacheck:1.2.0-alpine3.22.1-1

# Run Luacheck
docker run -v $(pwd):/workspace ragedunicorn/luacheck:latest script.lua

⁠Features

• 🚀 Small footprint: ~15MB runtime image
• 📦 Luacheck 1.2.0: Latest stable version installed via LuaRocks
• 🔍 Comprehensive analysis: Detects undefined globals, unused variables, unreachable code, and more
• 🏗️ Multi-platform: Supports linux/amd64 and linux/arm64
• ⚡ Fast: Pure Lua implementation with no external dependencies
• 🧵 Parallel checking: Bundled lanes package enables luacheck -j N for large codebases
• 🔒 Runs as non-root: Executes as nobody for security (required by lanes)

⁠Supported Standards

Lua versions: Lua 5.1, 5.2, 5.3, 5.4, LuaJIT
Frameworks: LÖVE, Minetest, Playdate SDK, OpenResty
Formatters: Default, Plain, TAP, JUnit, Visual Studio

⁠Usage Examples

⁠Lint entire project

docker run -v $(pwd):/workspace ragedunicorn/luacheck:latest .

⁠Check specific Lua version compatibility

docker run -v $(pwd):/workspace ragedunicorn/luacheck:latest \
  --std lua53 src/

⁠Ignore specific warnings

docker run -v $(pwd):/workspace ragedunicorn/luacheck:latest \
  --no-unused --no-redefined .

⁠Generate CI reports

# JUnit format for CI systems
docker run -v $(pwd):/workspace ragedunicorn/luacheck:latest \
  --formatter JUnit . > luacheck-report.xml

# TAP format
docker run -v $(pwd):/workspace ragedunicorn/luacheck:latest \
  --formatter TAP .

⁠Use configuration file

docker run -v $(pwd):/workspace ragedunicorn/luacheck:latest \
  --config .luacheckrc .

⁠Parallel checking on large codebases

docker run -v $(pwd):/workspace ragedunicorn/luacheck:latest -j 4 .

Set -j to the number of CPU cores to use. Backed by the bundled lanes package.

⁠File Permissions

The container runs as nobody (uid 65534). Files mounted at /workspace must be readable by that uid — world-readable files (mode 644, the typical default) work out of the box. If your files are more restrictive, run as your own user:

docker run --rm --user $(id -u):$(id -g) \
  -v $(pwd):/workspace:ro ragedunicorn/luacheck:latest .

Lanes must be configured by an unprivileged uid; passing --user 0:0 (root) will cause luacheck -j N to fail. Any non-root uid works.

⁠Tags

This image uses semantic versioning that includes all component versions:

Format: {luacheck_version}-alpine{alpine_version}-{build_number}

⁠Version Examples

• 1.2.0-alpine3.22.1-1 - Initial release with Luacheck 1.2.0 and Alpine 3.22.1
• 1.2.0-alpine3.22.1-2 - Rebuild of same versions (bug fixes, optimizations)
• 1.2.0-alpine3.22.2-1 - Alpine Linux patch update
• 1.3.0-alpine3.22.1-1 - Luacheck version update

When updates are available through automated dependency management, new releases are created with appropriate version tags.

⁠Links

• GitHub: https://github.com/RagedUnicorn/docker-luacheck⁠
• Issues: https://github.com/RagedUnicorn/docker-luacheck/issues⁠
• Releases: https://github.com/RagedUnicorn/docker-luacheck/releases⁠

⁠License

MIT License - See GitHub repository⁠ for details.