aboutsummaryrefslogtreecommitdiffstats
path: root/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'README.md')
-rw-r--r--README.md68
1 files changed, 62 insertions, 6 deletions
diff --git a/README.md b/README.md
index 9057a9a88..687877c73 100644
--- a/README.md
+++ b/README.md
@@ -22,6 +22,10 @@ $ firejail transmission-gtk # starting Transmission BitTorrent
22$ firejail vlc # starting VideoLAN Client 22$ firejail vlc # starting VideoLAN Client
23$ sudo firejail /etc/init.d/nginx start 23$ sudo firejail /etc/init.d/nginx start
24````` 24`````
25
26[![About Firejail](video.png)](http://www.youtube.com/watch?v=Yk1HVPOeoTc)
27
28
25Project webpage: https://firejail.wordpress.com/ 29Project webpage: https://firejail.wordpress.com/
26 30
27Download and Installation: https://firejail.wordpress.com/download-2/ 31Download and Installation: https://firejail.wordpress.com/download-2/
@@ -35,6 +39,17 @@ FAQ: https://firejail.wordpress.com/support/frequently-asked-questions/
35````` 39`````
36 40
37````` 41`````
42## Compile and install
43`````
44$ git clone https://github.com/netblue30/firejail.git
45$ cd firejail
46$ ./configure && make && sudo make install-strip
47`````
48On Debian/Ubuntu you will need to install git and a compiler:
49`````
50$ sudo apt-get install git build-essential
51`````
52
38## User submitted profile repositories 53## User submitted profile repositories
39 54
40If you keep your Firejail profiles in a public repository, please give us a link: 55If you keep your Firejail profiles in a public repository, please give us a link:
@@ -51,7 +66,9 @@ Use this issue to request new profiles: https://github.com/netblue30/firejail/is
51````` 66`````
52 67
53````` 68`````
54## AppImage type 2 support 69## AppImage
70
71Added AppImage type 2 support, and support for passing command line arguments to appimages.
55````` 72`````
56 73
57````` 74`````
@@ -75,9 +92,9 @@ Use this issue to request new profiles: https://github.com/netblue30/firejail/is
75 Example: 92 Example:
76 # firejail --private-srv=www /etc/init.d/apache2 start 93 # firejail --private-srv=www /etc/init.d/apache2 start
77 94
78 --machine-id 95 --machine-id
79 Preserve id number in /etc/machine-id file. By default a new 96 Spoof id number in /etc/machine-id file - a new random id is
80 random id is generated inside the sandbox. 97 generated inside the sandbox.
81 98
82 Example: 99 Example:
83 $ firejail --machine-id 100 $ firejail --machine-id
@@ -89,7 +106,46 @@ Use this issue to request new profiles: https://github.com/netblue30/firejail/is
89 Example: 106 Example:
90 $ firejail --allow-private-blacklist --private=~/priv-dir 107 $ firejail --allow-private-blacklist --private=~/priv-dir
91 --blacklist=~/.mozilla 108 --blacklist=~/.mozilla
109
110 --hosts-file=file
111 Use file as /etc/hosts.
112
113 Example:
114 $ firejail --hosts-file=~/myhosts firefox
92 115
116 --writable-var-log
117 Use the real /var/log directory, not a clone. By default, a
118 tmpfs is mounted on top of /var/log directory, and a skeleton
119 filesystem is created based on the original /var/log.
120
121 Example:
122 $ sudo firejail --writable-var-log
123
124 --git-install
125 Download, compile and install mainline git version of Firejail
126 from the official repository on GitHub. The software is
127 installed in /usr/local/bin, and takes precedence over the (old)
128 version installed in /usr/bin. If for any reason the new version
129 doesn't work, the user can uninstall it using --git-uninstall
130 command and revert to the old version.
131
132 Prerequisites: git and compile support are required for this com‐
133 mand to work. On Debian/Ubuntu systems this support is installed
134 using "sudo apt-get install build-essential git".
135
136 Example:
137
138 $ firejail --git-install
139
140 --git-uninstall
141 Remove the Firejail version previously installed in
142 /usr/local/bin using --git-install command.
143
144 Example:
145
146 $ firejail --git-uninstall
147
148
93````` 149`````
94## New Profiles 150## New Profiles
95xiphos, Tor Browser Bundle, display (imagemagik), Wire, mumble, zoom, Guayadeque, qemu, keypass2, 151xiphos, Tor Browser Bundle, display (imagemagik), Wire, mumble, zoom, Guayadeque, qemu, keypass2,
@@ -98,5 +154,5 @@ gjs, gnome-books, gnome-clocks, gnome-documents, gnome-maps, gnome-music, gnome-
98goobox, gpa, gpg, gpg-agent, highlight, img2txt, k3b, kate, lynx, mediainfo, nautilus, odt2txt, pdftotext, 154goobox, gpa, gpg, gpg-agent, highlight, img2txt, k3b, kate, lynx, mediainfo, nautilus, odt2txt, pdftotext,
99simple-scan, skanlite, ssh-agent, tracker, transmission-cli, transmission-show, w3m, xfburn, xpra, wget, 155simple-scan, skanlite, ssh-agent, tracker, transmission-cli, transmission-show, w3m, xfburn, xpra, wget,
100xed, pluma, Cryptocat, Bless, Gnome 2048, Gnome Calculator, Gnome Contacts, JD-GUI, Lollypop, MultiMC5, 156xed, pluma, Cryptocat, Bless, Gnome 2048, Gnome Calculator, Gnome Contacts, JD-GUI, Lollypop, MultiMC5,
101PDFSam, Pithos, Xonotic, wireshark, keepassx2, QupZilla 157PDFSam, Pithos, Xonotic, wireshark, keepassx2, QupZilla, FossaMail, Uzbl browser, xmms, iridium browser,
102 158Kino, Thunar