/nar-serve

Unpack and serve NAR file content on the fly

Primary LanguageGoApache License 2.0Apache-2.0

nar-serve - serve NAR file content

Push your build artifacts to one place.

All the files in https://cache.nixos.org are packed in NAR files which makes them not directly accessible. This service allows to download, decompress, unpack and serve any file in the cache on the fly.

Use cases

  • Avoid publishing build artifacts to both the binary cache and another service.
  • Allows to share build results easily.
  • Inspect the content of a NAR file.

Development

Inside the provided nix shell run:

./start-dev

This will create a small local server with live reload that emulates now.sh.

Currently, the default port is 8383. You can change it by setting the PORT environment variable.

Usage

Append any store path to the hostname to fetch and unpack it on the fly. That's it.

Eg:

Contributing

Contributions are welcome!

Before adding any new feature it might be best to first discuss them by creating a new issue in https://github.com/numtide/nar-serve/issues .

All code is licenses under the Apache 2.0 license.