LuaRocks
luarocks.org
- Free plan
- Windows
- macOS
- Linux
- API
- Self-hosted
What LuaRocks is
LuaRocks is a free package manager for Lua, while LuaRocks.org hosts rocks and rockspecs for Lua modules. The tool reads package manifests, selects a version and platform match, and installs the package locally. Rocks include version dependency information, which LuaRocks uses to install dependencies and load the appropriate module version. Package collections can use the root manifest, per-user manifests, or custom manifests. Development versions are kept in a separate manifest and are not installed by default. LuaRocks supports Linux, macOS, Windows, Unix, FreeBSD, and Cygwin, and supports offline installation. Its documentation lists manifests for all Lua versions and compatibility manifests for Lua 5.1, 5.2, 5.3, and 5.4. Module authors can register and upload a rockspec, then upload rock files for a particular version; the current release also supports publishing with `luarocks upload`. The application is described as pure Lua with no library dependencies, though its current release uses helper tools. HTTP mirror and GitHub manifest backups are listed as fallback package servers.
Who it suits
Lua developers can use LuaRocks to install modules and manage their dependencies. Module authors can publish packages, and teams can organize collections with custom manifests.
Good to know, and what to watch
- Resolves package dependencies and module versions
- Supports offline installation
- Custom manifests organize module collections
- Authors can publish with `luarocks upload`
- The current release uses helper tools
- Development versions are separate from default installs
Plans
Every plan and priceLuaRocks
Free plan
Getting started
- Open https://luarocks.org/
- Install LuaRocks using the Unix, BSD, macOS or Windows instructions
- Use the LuaRocks CLI to discover packages through manifests
- Install a rock or rockspec locally
- Upload a module with the `luarocks upload` command
Limits to check
LuaRocks is provided as a free plan at no cost. Development versions remain outside default installation because they are kept in a separate manifest.
The Club's review
LuaRocks is a free package manager and hosting service for Lua modules. It suits developers who need a consistent way to install, coordinate, or publish Lua code across several operating systems. Its strongest case is focused Lua dependency management; teams that require package-signing assurances should choose another registry.
Overview
LuaRocks uses manifests to discover modules, select a compatible version and platform, and install the matching .rock or .rockspec locally. A rock is a zip archive containing its rockspec and the files required to install a module. Version requirements embedded in rocks let LuaRocks bring in dependencies and load an appropriate module version, reducing manual coordination in projects with several interdependent libraries.
The root manifest works for the general public collection, while per-user and custom manifests support more controlled collections. A custom manifest may accept contributions or remain limited to its administrators. Development releases live in a separate development manifest and are excluded from normal installation, a useful safeguard against pulling unstable code accidentally. Offline installation is supported when packages have already been acquired and a machine cannot reach a repository.
Key features
Manifests and compatibility
Manifest files cover Lua modules broadly, with compatibility manifests for Lua 5.1, 5.2, 5.3, and 5.4. That makes version-targeted selection practical for projects supporting older Lua runtimes as well as current ones. An HTTP mirror and daily GitHub backups of stable and development manifest data provide fallback package-server options when the primary service is unavailable.
Publishing workflow
Anyone can register a module by uploading a rockspec, then add rock files for a particular version. The current release's luarocks upload command uses the LuaRocks.org HTTP API, so publishing can be performed from the same command-line ecosystem used for installation. This is a low-friction route for open-source Lua authors, while custom manifests provide a way to organize internal or curated collections.
Implementation and trust
LuaRocks is a pure Lua application with no library dependencies, although its current release uses helper tools. The package manager supports both .rock and .rockspec formats. A security incident page from 2019 states that packages did not have signing and verification at that time; organizations that need cryptographic package provenance should account for that limitation.
Pricing
LuaRocks costs nothing under the LuaRocks plan. It combines the package manager with module hosting and has no paid tier, free-trial period, seat charge, or usage quota stated. That makes it suitable for individual developers and teams that want a shared Lua registry without a subscription, but it also means there is no paid service level to buy when governance or assurance requirements increase.
Platforms
The service is exposed through an API and supports Linux, macOS, Windows, and self-hosted use. Installation guidance covers Unix systems including Linux and BSD variants, macOS, and Windows; supported platform listings also include FreeBSD and Cygwin. This breadth helps teams standardize Lua module handling across mixed workstations and deployment environments.
Who it's for
Lua application developers, library authors, and maintainers of Lua-specific internal collections are the natural audience. It is particularly useful when dependency versions must be resolved automatically, development builds kept out of normal installs, or packages installed without network access. It is a weaker fit for organizations seeking a broad multi-language registry, formal compliance controls, or signed-and-verified package distribution.
Pros and cons
Pros
- Purpose-built Lua workflow: manifests, rock formats, and version-aware dependency handling address Lua projects directly.
- Flexible collection control: root, per-user, custom, and separate development manifests support both public and curated module sets.
- Free publishing and installation: authors can upload rockspecs and rocks without a paid plan, and offline installation covers disconnected environments.
- Broad runtime coverage: compatibility manifests for Lua 5.1 through 5.4 help projects spanning multiple Lua generations.
Cons
- Package trust caveat: the 2019 incident page records that packages lacked signing and verification, which is a serious concern for high-assurance supply chains.
- Lua-only focus: teams managing several programming ecosystems will need another registry alongside LuaRocks.
- Helper-tool dependency in the current release: although the application is pure Lua, its installation environment is not entirely free of supporting tools.
Alternatives
Choose Inedo ProGet when you need a broader package platform with API, web, and self-hosted access; its free edition includes unlimited feeds for private packages and Docker, though security and compliance features are limited. Hex is a better choice for an Elixir-focused registry with unlimited public packages, documentation, and multiple package owners on its open-source plan. Pick npm for JavaScript and Node.js packages, including public publishing and registry access on its free plan.
aptly fits Debian package workflows with a CLI and HTTP REST service. pypiserver is appropriate for a minimal, self-hosted PyPI-compatible server. Bioconductor serves open-source bioinformatics packages without paid plans or stated usage limits. Maven Central suits community Java publishing, subject to file-count, release-size, and release-count limits on its free plan. MELPA is the relevant alternative for Emacs Lisp packages and requires Emacs 24.1 or later with package.el.
For broader comparisons, see Package Registries and Package Managers.
Verdict
Choose LuaRocks if you build or publish Lua modules and want free, manifest-driven dependency resolution across Linux, macOS, Windows, and Unix environments. Its focused formats, compatibility manifests, custom collections, and offline installs make it a practical default for Lua teams. Look elsewhere when signed package verification, formal compliance controls, or a multi-language repository is a primary requirement.
The verdict
LuaRocks combines local package installation, dependency handling, and module publishing for Lua. Its manifest options and broad listed platform support suit developers managing Lua modules across different environments.
Questions people ask
What does LuaRocks cost?
The LuaRocks plan is free at no cost.
Which platforms does LuaRocks support?
It supports Linux, macOS, Windows, Unix, FreeBSD and Cygwin.
Can LuaRocks install packages offline?
Yes, offline installation is supported.
What package formats does it use?
LuaRocks works with .rock and .rockspec formats; a rock is a zip file containing its rockspec and installation files.
Can developers publish modules?
Yes. Authors can register a module with a rockspec and upload rock files, including through `luarocks upload`.
How are Lua versions handled?
LuaRocks.org provides general manifests and compatibility manifests for Lua 5.1, 5.2, 5.3 and 5.4.
What the maker publishes
- Alternate sources
- The documentation lists an HTTP mirror and GitHub manifest backups that can be used as fallback package servers. source
- Compatibility
- LuaRocks.org provides manifest files for all Lua versions and for Lua 5.1, 5.2, 5.3, and 5.4. source
- Custom manifests
- Users can create custom manifests, which can be open to contributions or closed to manifest admins. source
- Dependencies
- LuaRocks is a pure Lua application with no library dependencies, though its current release uses helper tools. source
- Dependency handling
- Rocks include version dependency information, which LuaRocks uses to install dependencies and load the appropriate module version. source
- Dependency resolution
- Yes source
- Development releases
- Development versions are placed in a separate development manifest so they are not installed by default. source
- Development versions
- Development versions are kept in a development manifest so they are not installed by default. source
- Free plan
- Yes source
- Implementation
- LuaRocks is described as a pure Lua application with no library dependencies; its current release uses helper tools. source
- Installation platforms
- The download guide links installation instructions for Unix systems including Linux and BSDs, macOS, and Windows. source
- Install packages
- LuaRocks downloads package manifests, selects a version and platform match, and installs the corresponding rock or rockspec locally. source
- Integration
- The LuaRocks.org HTTP API is used by the luarocks upload command to publish rocks. source
- Lua compatibility
- The documentation lists manifests for all modules and separate compatibility manifests for Lua 5.1, 5.2, 5.3, and 5.4. source
- Mirrors
- The documentation lists an HTTP mirror and daily GitHub backups of stable and development manifest data as fallback servers. source
- Module publishing
- Anyone can register and upload a Lua module by uploading a .rockspec. source
- Offline installation
- Yes source
- Package discovery
- The LuaRocks CLI uses manifests to discover and install packages. source
- Package format
- A rock is a zip file containing the rockspec and all files needed to install a module. source
- Package formats
- .rock,.rockspec source
- Package formats
- A rock is a zip file containing its rockspec and the files needed to install a module; rocks can be built for specific platforms. source
- Platforms
- The download instructions cover Unix systems, macOS, and Windows; Unix examples include Linux and BSDs. source
- Publishing
- Anyone can register and upload a Lua module by uploading a rockspec, then upload rock files for a specific version. source
- Purpose
- LuaRocks is a package manager for Lua, and LuaRocks.org hosts rocks and rockspecs for Lua modules. source
Checked against the maker's pages on 8 Oct 2026.