The sandbox
A paper’s.tex files are code your co-authors wrote, and TeX runs them on
your computer. So each compile runs inside the operating system’s own
sandbox: TeX may read only its own files and the paper, may write only in the
paper’s compile folder, may start only TeX and the programs TeX needs, and
has no network. Your home folder, your other files and your keys stay out of
its reach.
What that needs differs by operating system.
macOS
Nothing. The sandbox is built into macOS.Linux
Compiling uses bubblewrap. Install it with your package manager:Ubuntu 24.04 and later
Ubuntu 24.04 limits the sandboxes programs may make for themselves (itskernel.apparmor_restrict_unprivileged_userns setting), so bubblewrap is
installed but cannot make one. Compile then says so, and nothing runs.
To allow bubblewrap, and nothing else, give it an AppArmor profile. This
needs an administrator once per computer:
Windows
Compiling runs TeX inside WSL 2, in the same bubblewrap sandbox as Linux, with your Windows drives hidden from it. Orchestra installs TeX Live inside WSL, not on Windows itself.- Install WSL 2, if it is not there yet. In a terminal opened as
administrator, run
wsl --install, then restart. - Inside WSL, install bubblewrap:
sudo apt install bubblewrap.
When Compile says it cannot run
Until a compile can run, you can still write, review and comment on the paper,
and download its source to compile elsewhere.