Skip to content

Showcase

A few ways to explore what jrun can do beyond the basics.

AstroNvim in a jail

Run a full AstroNvim setup without installing anything on your host.

jail "astronvim" {
  setup {
    astronvim { type = "ansible"; url = "hub://astronvim/rolling"; }
  }
  mount {
    src { host = "."; jail = "/srv/project"; }
  }
}

jrun up nvim.ucl
jrun cmd astronvim nvim

Alias it in ~/.zshrc and use it as if it were installed locally:

alias nvim="jrun cmd astronvim nvim"

You can stack playbooks too — here's an OCaml environment with AstroNvim and a custom config, all composed layer by layer:

jail "fp-astronvim" {
  setup {
    ocaml     { type = "ansible"; url  = "hub://ocaml/rolling"; }
    astronvim { type = "ansible"; url  = "hub://astronvim/rolling"; }
    custom    { type = "ansible"; file = "local/playbook.yml"; }
  }
  mount {
    src { host = "."; jail = "/srv/project"; }
  }
}

Hugo with live reload

A complete Hugo environment inside a jail with live file watching. You edit on your host, Hugo rebuilds inside the jail.

Create an empty project directory, then define the jail:

jail "hugoplate" {
  setup {
    hugo {
      type = "ansible";
      url  = "hub://hugoplate/0.157";
      vars { HUGO_SITE_DIR = "/srv/project"; }
    }
  }
  mount {
    src { host = "~/Projects/hugo"; jail = "/srv/project"; }
  }
  forward {
    http { host = 1313; jail = 1313; }
  }
  exec {
    build {
      cmd = "hugo server --source /srv/project --bind 0.0.0.0 --port 1313 --poll 1s";
    }
  }
}

jrun up hugo.ucl

Open http://localhost:1313 — edit files on your host, Hugo picks up changes instantly.

Boot into XFCE

Jailrun isn't limited to headless services. Provision a full FreeBSD desktop and launch the VM with a graphical window.

Stop the VM if it's running, then create a base.ucl:

base {
  setup {
    desktop { type = "ansible"; url = "hub://xfce/rolling"; }
  }
}

jrun start --base base.ucl --mode graphic

A few minutes later — a full XFCE desktop running inside FreeBSD. A KDE Plasma variant is also available in Jailrun Hub.