Commit graph

743 commits

Author SHA1 Message Date
Kelvin M. Klann
cb12f77632
docs: recommend .deb or building from source on debian/ubuntu (#7110)
Most recent releases:

* firejail 0.9.72: 2023-01-16
* firejail 0.9.74: 2025-03-24
* firejail 0.9.76: 2025-07-30
* firejail 0.9.78: 2026-01-03
* firejail 0.9.80: 2026-03-14

firejail 0.9.76 was released over 6 months ago, but the packages from
both Debian stable (13 / Trixie) and the Ubuntu PPA appear to still be
on firejail 0.9.74, which is over 1 year old[1] [2].

As for installing firejail through Debian backports, it is unclear to me
if that is currently working and if so, which firejail version would be
installed on each Debian version.

Lastly, the packages on Ubuntu seem to still be on firejail 0.9.72,
which is over 3 years old, even on the latest Ubuntu 25.10 and on the
upcoming Ubuntu 26.04[3].

So to avoid bugs and bug reports caused by old firejail versions,
recommend either installing the release .deb file from GitHub or
building from source on Debian/Ubuntu.

Relates to #6842 #7060.

[1] https://tracker.debian.org/pkg/firejail
[2] https://launchpad.net/~deki/+archive/ubuntu/firejail
[3] https://launchpad.net/ubuntu/+source/firejail
2026-03-26 16:32:18 +00:00
netblue30
4b3ab56040 README.md 2026-03-14 08:54:39 -04:00
Kelvin M. Klann
09329b990f modif: replace --keep-hostname with new --hostname-randomize
Changes:

* Keep hostname by default (same as using `--keep-hostname`)
* Add  `--hostname-randomize` command to randomize the hostname
* Ignore `--keep-hostname` command and print a warning if it is used

Setting a different hostname inside of the sandbox may prevent X11
programs from authenticating to the X server and displaying windows at
all (see #7062).

To avoid breakage, keep the hostname as is by default and only set it to
a random value if a new `hostname-randomize` command is used.

This also avoids potentially surprising behavior, as the user might not
expect the hostname to be changed inside of the sandbox, considering
that usually the protections that are applied firejail involve
restricting access to resources (like file paths), rather than modifying
their values inside of the sandbox.

Fixes #7062

Relates to #7048 #7069.
2026-03-08 02:12:26 -03:00
Kelvin M. Klann
5197451f54 docs: man: use full program paths for --profile=FILE examples
Related commits:

* 188d5f16d ("--profile=FILE rework (#6896)", 2026-01-05).
* 54a741ecc ("update README.md", 2026-01-05)

See commit 491b46cfa ("docs: always use full path to program in examples
(#6963)", 2025-11-16).
2026-03-05 05:06:47 -03:00
Kelvin M. Klann
0a67d84108 README.md: fix misc text and formatting
Related commits:

* 54a741ecc ("update README.md", 2026-01-05)
* d3f182543 ("Hide/Mask firejail process (pid 1) inside sandbox #7046",
  2026-02-02)
* 026332a81 ("merges", 2026-02-08)

Relates to #7046 #7069.
2026-03-05 04:58:35 -03:00
netblue30
026332a819 merges 2026-02-08 07:17:26 -05:00
netblue30
f7c80ab0ee testing; adding pierretom to the commiters list 2026-02-02 08:26:23 -05:00
netblue30
d3f182543d Hide/Mask firejail process (pid 1) inside sandbox #7046 2026-02-02 07:39:36 -05:00
netblue30
c2f982ad9f spelling 2026-01-08 08:08:15 -05:00
netblue30
e256efe645 fix non-ASCII hypehens in manpages (#5903) 2026-01-08 08:03:24 -05:00
netblue30
fcbd02c923 small fix for README.md 2026-01-05 13:19:03 -05:00
netblue30
54a741ecc3 update README.md 2026-01-05 13:16:14 -05:00
Kelvin M. Klann
0963b9ef00 docs: README.md: improve formatting of 0.9.78 section
Related commits:

* 36df4e61c ("0.9.78 is out", 2026-01-02)
* 524d67aa7 ("main page", 2026-01-02)
* bf05f54f1 ("main page", 2026-01-02)
2026-01-03 00:23:48 -03:00
netblue30
bf05f54f12 main page 2026-01-02 19:23:39 -05:00
netblue30
524d67aa77 main page 2026-01-02 19:22:19 -05:00
netblue30
36df4e61c1 0.9.78 is out 2026-01-02 19:08:16 -05:00
netblue30
be92d316f6 merges 2025-12-12 08:57:18 -05:00
Kelvin M. Klann
d4c896a0c0 docs: README.md: add missing closing parens
This amends commit 05cf5cd93 ("docs: add distribution-specific
build/install instructions (#6964)", 2025-11-15).
2025-11-19 04:13:17 -03:00
Kelvin M. Klann
491b46cfa3
docs: always use full path to program in examples (#6963)
And add it to the bug report template checklist.

To avoid potential issues due to firejail-in-firejail.

Commands used to search and replace:

    perl -pi -e '
      s/(firejail)( .*)? (blobby|dig|firefox|galculator|gedit|gimp|handbrake|icecat|iceweasel|mc|openbox|transmission|vlc|warzone2100|wget|xed|xterm)/$1$2 \/usr\/bin\/$3/;
    ' README.md src/firejail/usage.c src/man/*.in
    perl -pi -e 's/^\s*(firefox \\?-)/\/usr\/bin\/$1/' \
      src/man/firejail.1.in

Note: Some parts were edited manually.

Note: Most tests still use the program basename.

Relates to #2877.
2025-11-16 08:39:05 +00:00
Kelvin M. Klann
be065d1301
docs: clarify that only latest and dev versions are supported (#6965)
To avoid wasting time due to (for example):

* Bugs that were already fixed
* Old versions with different/missing verbosity in the output
* Behavior that only affects (or differs in) old versions
* Copying and pasting profile lines which contain commands that are
  unsupported in old versions (or that depend on other changes to
  profiles in the current version)

This is a follow-up to #6964.
2025-11-15 04:53:08 +00:00
Kelvin M. Klann
05cf5cd93c
docs: add distribution-specific build/install instructions (#6964)
For better integration with the system and package manager.

Based on .gitlab-ci.yml.

This is a follow-up to #6962.
2025-11-15 03:53:20 +00:00
Kelvin M. Klann
7e26e940c2 docs: add "make installcheck" to build/install commands
This amends commit e5acc7997 ("docs: improve build/install commands
(#6962)", 2025-11-12).
2025-11-11 22:35:21 -03:00
Kelvin M. Klann
e5acc79976
docs: improve build/install commands (#6962)
Changes:

* Format
* Quote URL
* Use `&&` where applicable
* Use parallel make

Kind of relates to commit 500d8f2d6 ("ci: run make in parallel where
applicable", 2023-08-14) / PR #5960.
2025-11-12 00:46:39 +00:00
netblue30
746d7c6ee1 updated profile stats 2025-08-20 10:30:50 -04:00
Kelvin M. Klann
8d099f623c docs: README.md: fix misc formatting
This amends commit e108976f5 ("added signature to release 0.9.76,
updated main page, small modifs for mkasc.sh", 2025-08-17).
2025-08-18 04:59:02 -03:00
Kelvin M. Klann
d9bb7ed4bd docs: README.md: improve 0.9.76 text and add links to xorg issue
This amends commit e108976f5 ("added signature to release 0.9.76,
updated main page, small modifs for mkasc.sh", 2025-08-17).

Relates to #6773 #6775.
2025-08-18 04:56:07 -03:00
netblue30
e108976f5a added signature to release 0.9.76, updated main page, small modifs for mkasc.sh 2025-08-17 09:44:50 -04:00
Kelvin M. Klann
48673abd0d
docs: add debian/ubuntu links to README.md (#6850)
The Debian CI site is apparently used for testing packages before the
official Debian packages are built.

Currently it is only listed in places like #6702, so add it to the main
list to make it easier to find.

Also add links for the Debian Package Tracker and Ubuntu PPA since they
are related.

Relates to #6702 #6842.
2025-08-05 07:48:32 +00:00
Tavi
622c59f53f
rel 0.9.76
Signed-off-by: Tavi <tavi@divested.dev>
2025-07-30 07:12:13 -04:00
netblue30
c8b85ffdb4 moving to 0.9.75 2025-03-25 10:00:30 -04:00
netblue30
f358159795 merges 2024-12-18 09:44:45 -05:00
netblue30
66c8b86b0d readme/readme.md fixes 2024-12-16 08:46:39 -05:00
netblue30
01c5dc4f00
Merge pull request #6407 from kmk3/docs-readme-firetools
docs: clarify that other tools may not be in PPA
2024-12-15 09:52:45 -05:00
Ted Robertson
d763fb73ca
docs: clarify intro and build section in README (#6524)
Make the introduction friendlier for non-kernel geeks and clarify the
build section.

Relates to #4049.
2024-11-04 18:58:24 +00:00
Ted Robertson
cf02e8dd4f
docs: fix typos of --enable-selinux configure option (#6526) 2024-10-31 18:48:37 +00:00
Kelvin M. Klann
bba4af3f01 docs: clarify that other tools may not be in PPA
Relates to #6406.

Reported-by: @Lidoca
2024-07-15 08:25:52 -03:00
Kelvin M. Klann
6ba0e38241 README.md: fix Landlock support list
Fix formatting and wrong/outdated information.

This amends commit 6d0559de7 ("landlock: update README.md, small fix in
man firejal; update profile stats in README.md", 2023-12-04).

Relates to #6078.
2023-12-05 11:19:04 -03:00
glitsj16
666063f575 docs: fix typo of --nonewprivs in Landlock section
Originally from PR #5359.

Relates to #6078.
2023-12-05 11:00:06 -03:00
netblue30
6d0559de7d landlock: update README.md, small fix in man firejal; update profile stats in README.md 2023-12-04 10:20:51 -05:00
Kelvin M. Klann
5639359664 docs: add missing CI badges to README.md 2023-08-22 04:58:21 -03:00
Kelvin M. Klann
1c9af28611 ci: move main code checks into new check-c.yml
Move scan-build, cppcheck and CodeQL (cpp).

This is similar to build-extra.yml, but for jobs that check for issues
in the code rather than checking for build failures.

Note: As this deletes codeql-analysis.yml, its configuration also has to
be deleted in the GitHub web UI to prevent it from warning about the
file being missing:

* Security -> Code scanning -> Tool status -> (Setup Types) CodeQL ->
  (Configurations) language:python -> Delete configuration

Misc: The above was clarified by @topimiettinen[1].

[1] https://github.com/netblue30/firejail/pull/5960#issuecomment-1685262643
2023-08-22 04:58:21 -03:00
Kelvin M. Klann
29f7a94610 ci: remove "CI" from workflow names
All of the current workflows are used for CI.
2023-08-20 12:31:14 -03:00
Kelvin M. Klann
3f52c0e26e docs: add uninstall instructions to README.md
Clarify how to remove the symlinks created by firecfg.

Reported by @MikeNavy in #5098.
2023-05-02 09:31:22 -03:00
Kelvin M. Klann
a516247a1c docs: line-wrap markdown and use double-spacing
Use two spaces to separate sentences to make the source easier to read
in monospace fonts (such as when editing or reviewing it), especially
for longer paragraphs.  The HTML output should still look the same.

Misc: This also removes source-level ambiguity regarding abbreviations
(such as "Mr.") vs the end of sentences and enables moving between
sentences in vi with `(` and `)`, for example.
2023-03-26 13:52:11 -03:00
Kelvin M. Klann
331158da03 docs: line-wrap some long lines 2023-03-26 13:51:25 -03:00
Kelvin M. Klann
82eecd4c78 docs: fix misc texts/formatting 2023-03-26 13:51:25 -03:00
Kelvin M. Klann
79c52d8e97 docs: clarify and improve links and items
Changes:

* Add titles to referenced issues/discussions
* Use relative links for paths
* Separate repo paths from installed paths
* Turn some links and items into lists to make them stand out
2023-03-26 13:50:54 -03:00
Kelvin M. Klann
6db6af6a94 README.md: improve badges/links 2023-03-26 12:48:50 -03:00
Kelvin M. Klann
e4aa6b1d6c README.md: sort badges
Put lint after builds.
2023-03-26 12:48:50 -03:00
Kelvin M. Klann
6eca8eb99a README.md: add full repology list inside details tag
And clarify the distribution installation steps.
2023-03-26 12:48:36 -03:00