aboutsummaryrefslogtreecommitdiffhomepage
path: root/README.md
blob: 1cea999372e9d68ab88c0b1d944c0b5377bbe7b3 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
Firectl
=======

Firectl is a tool to integrate [firejail](https://firejail.wordpress.com/)
sandboxing in the Linux desktop. Enable firejail for an application and enjoy a
more secure desktop.

# Usage

To see which applications can be enabled:
``` bash
firectl status
```

To enable firejail for a program:
``` bash
sudo firectl enable firefox
```

To disable firejail for a program:
``` bash
sudo firectl disable firefox
```

# Restoring

Firectl works by modifying the system's desktop files, the files that tell the
system which user applications are installed and how to run them. When these
applications are updated, the desktop files are also updated, disabling
firejail. The firectl settings need to be restored.

For now you have to manually restore firejail settings after upgrades:
``` bash
sudo firectl restore
```
In the future restoring should be automatic.

# Install

Firectl can be installed with pip:
``` bash
sudo pip3 install firectl
```

# Uninstall

To uninstall firectl:
``` bash
sudo firectl disable all
sudo pip3 uninstall firectl
sudo rm /etc/firejail/firectl.conf
```