Security is personal, everybody seems to have a different opinion. It varies from person to person, and from country to country. In Firejail project we don’t use any particular definition, and we don’t follow the mainstream view on cybersecurity. Instead, we let the user go through the feature list and decide for himself if this will help him or not. Here is our feature list.


Linux namespaces

The core technology behind Firejail is Linux Namespaces, a lightweight form of virtualization. We use it as the first step in isolating the application. Basically, the app gets its own filesystem, network stack, and kernel interface. It is blazing fast, and consumes virtually no additional memory. We just configure it, and the kernel does all the heavy lifting.


Access Control

On top of the regular file system, the sandbox deploys a very efficient Mandatory Access Control. It allows or restricts application access to the underlying file system on a file by file basis.

Access operations:

  • blacklisting – deny access to files and directories. Access attempts are reported to syslog.
  • whitelisting – allow only the files and directories specified by the user.
  • read-only, read-write, noexec – set file and directory attributes.
  • temporary filesystem – mount a temporary filesystem on top of a directory.
  • bind – bind-mount a file or directory on top of another file or directory.
  • private – bring in copies of files and directories and discard them when the sandbox is closed.
  • restricted user home – only the current user home directory is available inside the sandbox. This is also reflected in the structure of /etc/passwd and /etc/group files.
  • reduced system information leakage – restrict access to directories such as /boot, /proc, and /sys.

Virtual Directories

This is an advanced form of access control we deploy in all our sandboxes. It is built using whitelist access control operation.

Let’s say we want to restrict browser access to our home directories. We start by mounting an empty temporary file system on top of /home/user directory, and them bring in Downloads and various configuration directories the browser is using. Then we copy .bashrc and .Xauthority files to get bash shell and X11 working inside the sandbox. We end up with a pristine looking home directory, where all private user files have disappeared. For email clients we also add mail directory, for multimedia players we add Music, Videos and so on.

We deploy virtual directories all over the Linux file system, allowing in our sandbox only the files necessary for the application to function.


Virtual home directory in Mozilla Firefox

Security filters

The following security filters are currently implemented:

  • seccomp-bpf – a simple, yet effective sandboxing technology, seccomp-bpf allows the sandbox to attach a system call filter to a process and all its descendants, thus reducing the attack surface of the kernel.
  • protocol – based on seccomp, it filters the first argument of socket system call. Most default profiles allow only UNIX, IPv4 and IPv6 communication protocols.
  • noroot user namespace – install a user namespace with only one valid user, the current user.
  • Linux capabilities – Linux Capabilities (POSIX 1003.1e) are designed to split up the root privilege into a set of distinct privileges which can be independently enabled or disabled. These are used to restrict what a process running as root can do in the system. Most default profiles disable all capabilities.
  • X11 sandboxing support is built around two external X11 server software packages, Xpra and Xephyr.
  • D-BUS filtering
  • AppArmor and SELinux support
An Openbox desktop manager running in a Xephyr/X11 Firejail sandbox

Networking support

Network namespace configured in a Firejail sandbox

Firejail can attach a new TCP/IP networking stack to the sandbox. The new stack comes with its own routing table, firewall, and set of interfaces. Implemented as a Linux namespace inside the kernel, the stack is totally independent.

These are the networking operations supported by Firejail:

  • create new interfaces – create Linux kernel macvlan and bridge devices and move them in the sandbox.
  • move existing interfaces inside the sandbox. The interface configuration is preserved. We use this feature to connect sandboxes to specific VLANs.
  • assign addresses – Firejail assigns IP addresses automatically using a simple ARP-scan mechanism. The user can also specify IP addresses. Both IPv4 and IPv6 are supported. Assigning addresses using DHCP is also supported.
  • hostname support.
  • DNS and encrypted DNS support.
  • Linux netfilter support – a custom netfilter configuration can be installed in the sandbox. Several filter examples using the regular netfilter/iptables syntax are provided with the sandbox software.
  • network locking support – builds and deploys a custom firewall allowing network traffic only to the addresses accessed in the first o one minute of sandbox operation. This feature comes in handy when sandboxing programs that talk only to a small number of IP addresses, such as mail clients, games, Tor browser.
  • traffic tracing – a simple traffic monitor for TCP and UDP streams.
  • traffic shaping – control the amount of data that flows into and out of sandboxes.

Security profiles

Located in /etc/firejail directory, profile files describe the filesystem container, the security filters and network configuration.

Most default security profiles use a restrictive dual 32-bit/64-bit seccomp-bpf filter, disable all capabilities, and enable a noroot user namespace inside the sandbox. The filesystem denies access to password and encryption keys. Some application classes such as games and web browsers use a virtual home directory, therefore hiding all private user files.

Default profile statistics describing the various technologies used by Firejail. More than 1000 application profiles are available by default in /etc/firejail as of version 0.9.64.

Resource allocation

Allocate resources such as CPU time, system memory, and network bandwidth, using Linux Control Groups and Linux rlimits.


Universal packaging formats

Firejail supports AppImage packaging format natively. Simply add –appimage command line option and the package is mounted and run inside the sandbox.


Sandbox auditing

We make available a simple tool, jailcheck, for auditing user sandboxes. Running as root, the program attaches itself to all running sandboxes, and it looks for major security problems with current user’s configuration.

jailcheck, a simple tool for auditing sandboxes

Statistics and monitoring

Firejail provides a large number of options to track all the aspects of sandboxed applications. This includes monitoring CPU/memory/bandwidth usage, tracing system calls, monitoring exec and fork events, and logging accesses to blacklisted files and directories.

Monitoring sandboxes with “firejail –top”

Graphical user interface

A GUI application, Firetools, is available as a separate software package.

Firefox Aurora sandbox statistics

22 thoughts on “Features

  1. Pingback: Обновление системы изоляции приложений Firejail 0.9.42 | Linux-House.ru

  2. Tom

    Hi there,
    Sorry if this is not the smartest to ask and ive overlooked in my complacency.
    Firejail is amazing, thank you. Ease of use and abilities. Hats off to you, though had me thinking. Can it box the entire OS and have more box’s inside that as they usually are set on chrome and firefox etc etc..?
    I’m a week into my journey of Linux, apologies again if this is a bit of a….idioitic question


    1. netblue30 Post author

      Thanks for your kind words. The idea so far was to target specific applications, such as Firefox and Chromium, or closed source apps like Steam and Skype. We are moving in the direction of sandboxing a full OS, but it will take some time to get there.


  3. Pingback: Firejail Tutorial – eirenicon llc

  4. Pingback: Firejail - Securely Run Untrusted Applications in Linux

  5. Pingback: Securely Run Untrusted Applications in Linux | Top Tech Stories

  6. Pingback: Securely Run Untrusted Applications in Linux | Tech News One

  7. Pingback: Firejail – Securely Run Untrusted Applications in Linux – Clockwork Network

  8. Pingback: Firejail, ejecuta de forma segura aplicaciones no confiables en Ubuntu

  9. Pingback: Выпуск системы изоляции приложений Firejail 0.9.60 — AllUNIX.ru — Всероссийский портал о UNIX-системах

  10. Pingback: Выпуск системы изоляции приложений Firejail 0.9.60 |

  11. Pingback: Выпуск системы изоляции приложений Firejail 0.9.62 |

  12. Pingback: Firejail - Führen Sie nicht vertrauenswürdige Anwendungen unter Linux sicher aus - okidk.de

  13. Pingback: Firejail - безопасный запуск потенциально уязвимых приложений

  14. Pingback: [linux] 파일 열기, 분기 등을 방지하는 Linux의 샌드 박스에서 신뢰할 수없는 C 프로그램을 실행 하시겠습니까? - 리뷰나라

  15. Pingback: Execute com segurança aplicativos não confiáveis ​​no Linux - Okdk

  16. Pingback: Firejail - Chạy an toàn các ứng dụng không đáng tin cậy trong Linux - 2Error.net

  17. Pingback: ¿Ejecutar un programa C que no es de confianza en un espacio aislado en Linux que le impide abrir archivos, bifurcarse, etc.? - Fallosweb.com

  18. Pingback: Run an untrusted C program in a sandbox in Linux that prevents it from opening files, forking, etc.? - The Citrus Report

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s