No description
- Nix 50.8%
- Haskell 49.1%
`base-permissions.nix` was the source of truth for all of the base combinators, but it was not documented well anywhere. To make this easier and more obvious for users, this commit pulls all remaining custom permissions into a new `base` combinator which is included by default. This way there is no more undocumented permissions included by default, they are all documented in the `Default included combinators` section of the docs. This should also make it easier to override base permissions because users can now just specify `base` instead of all of the `unsafe-add-raw-args` calls unless they really want to change them. |
||
|---|---|---|
| lib | ||
| tests | ||
| website | ||
| .build.yml | ||
| default.nix | ||
| flake.nix | ||
| LICENSE | ||
| README.md | ||
jail.nix
A helper to make it easy and ergonomic to wrap your derivations in bubblewrap.
Please send patches, questions and discussions to my general mailing list.
Getting Started
Documentation to install and get started can be found here.
Example
# flake.nix
{
inputs.nixpkgs.url = "github:NixOS/nixpkgs/nixos-24.11";
inputs.jail-nix.url = "sourcehut:~alexdavid/jail.nix";
outputs = { nixpkgs, jail-nix, ... }: let
pkgs = import nixpkgs { system = "x86_64-linux"; };
jail = jail-nix.lib.init pkgs;
untrusted-package = pkgs.writeScriptBin "untrusted" ''
ls -la $HOME
'';
in {
packages.x86_64-linux.jailed = jail "my-jail" untrusted-package (with jail.combinators; [
# See combinators section below for more functions that can go here
# Give program access to the network
network
# Allow program to create windows
gui
# Give program access to the GPU
gpu
# Give program read-only access to /var/log/journal
(readonly "/var/log/journal")
# Mount ~/foo to /bar in the jail as read-write
# (noescape due to `~` — all arguments are shell escaped by default)
(rw-bind (noescape "~/foo") "/bar")
]);
};
}
Combinators
By default, only the bare minimum permissions are exposed. By passing combinators into the jail you can modify the jail to expose more permissions.
Click here for a full list of combinators and their documentation.