github-starred/firejail
2
0
Fork 0
mirror of https://github.com/netblue30/firejail.git synced 2026-05-15 14:16:14 -06:00
Code Issues 531 Projects Packages Wiki Activity Actions 6

[GH-ISSUE #5049] docs: users are told to include main .profile in .local profile #2863

New issue
Open
opened 2026-05-05 09:31:29 -06:00 by gitea-mirror · 10 comments
gitea-mirror commented 2026-05-05 09:31:29 -06:00
Owner
Copy link

Originally created by @zithro on GitHub (Mar 14, 2022).
Original GitHub issue: https://github.com/netblue30/firejail/issues/5049

Originally assigned to: @netblue30 on GitHub.

Hello, it's not a software bug I'm reporting, rather a documentation one (so I didn't use the template).
I followed "documentation-2/building-custom-profiles/" to build a vlc custom profile, as this:

net none
include /etc/firejail/vlc.profile

But when running firejail vlc, I enter in an include loop :

Reading profile /etc/firejail/vlc.profile
Reading profile /home/zithro/.config/firejail/vlc.local
[...]
Reading profile /etc/firejail/vlc.profile
Error: maximum profile include level was reached

Removing the include solves it.
Is it because I'm running the latest version (0.9.68) and the documentation was written using an older version ?

Originally created by @zithro on GitHub (Mar 14, 2022). Original GitHub issue: https://github.com/netblue30/firejail/issues/5049 Originally assigned to: @netblue30 on GitHub. Hello, it's not a software bug I'm reporting, rather a documentation one (so I didn't use the template). I followed "documentation-2/building-custom-profiles/" to build a vlc custom profile, as this: ``` net none include /etc/firejail/vlc.profile ``` But when running `firejail vlc`, I enter in an include loop : ``` Reading profile /etc/firejail/vlc.profile Reading profile /home/zithro/.config/firejail/vlc.local [...] Reading profile /etc/firejail/vlc.profile Error: maximum profile include level was reached ``` Removing the include solves it. Is it because I'm running the latest version (0.9.68) and the documentation was written using an older version ?
gitea-mirror added the
bug
wordpress
documentation
 labels 2026-05-05 09:31:29 -06:00
gitea-mirror commented 2026-05-05 09:31:31 -06:00
Author
Owner
Copy link

@rusty-snake commented on GitHub (Mar 15, 2022):

include /etc/firejail/vlc.profile is not needed (at wrong) if you use a .local.

If you use /home/zithro/.config/firejail/vlc.local (as you should with newer versions of firejail) net none is all you need.

<!-- gh-comment-id:1068125479 --> @rusty-snake commented on GitHub (Mar 15, 2022): `include /etc/firejail/vlc.profile` is not needed (at wrong) if you use a .local. If you use `/home/zithro/.config/firejail/vlc.local` (as you should with newer versions of firejail) `net none` is all you need.
gitea-mirror commented 2026-05-05 09:31:32 -06:00
Author
Owner
Copy link

@kmk3 commented on GitHub (Mar 15, 2022):

@zithro commented on Mar 14:

Hello, it's not a software bug I'm reporting, rather a documentation one (so
I didn't use the template). I followed
"documentation-2/building-custom-profiles/" to build a vlc custom profile, as
this:

net none
include /etc/firejail/vlc.profile

But when running firejail vlc, I enter in an include loop :

Reading profile /etc/firejail/vlc.profile
Reading profile /home/zithro/.config/firejail/vlc.local
[...]
Reading profile /etc/firejail/vlc.profile
Error: maximum profile include level was reached

Removing the include solves it. Is it because I'm running the latest version
(0.9.68) and the documentation was written using an older version ?

/etc/firejail/vlc.profile contains:

include vlc.local

On every include command, firejail will first look for the file in
~/.config/firejail. If it does not exist, it will look for the file in
/etc/firejail.

If both vlc.profile and vlc.local include each other, then you have an infinite
inclusion loop.

<!-- gh-comment-id:1068381211 --> @kmk3 commented on GitHub (Mar 15, 2022): @zithro commented [on Mar 14](https://github.com/netblue30/firejail/issues/5049#issue-1168945593): > Hello, it's not a software bug I'm reporting, rather a documentation one (so > I didn't use the template). I followed > "documentation-2/building-custom-profiles/" to build a vlc custom profile, as > this: > > ``` > net none > include /etc/firejail/vlc.profile > ``` > > But when running `firejail vlc`, I enter in an include loop : > > ``` > Reading profile /etc/firejail/vlc.profile > Reading profile /home/zithro/.config/firejail/vlc.local > [...] > Reading profile /etc/firejail/vlc.profile > Error: maximum profile include level was reached > ``` > > Removing the include solves it. Is it because I'm running the latest version > (0.9.68) and the documentation was written using an older version ? /etc/firejail/vlc.profile contains: ``` include vlc.local ``` On every include command, firejail will first look for the file in ~/.config/firejail. If it does not exist, it will look for the file in /etc/firejail. If both vlc.profile and vlc.local include each other, then you have an infinite inclusion loop.
gitea-mirror commented 2026-05-05 09:31:33 -06:00
Author
Owner
Copy link

@zithro commented on GitHub (Mar 16, 2022):

Hey guys, thanks for the clarification, so I think the docs need an update ;)
"documentation-2/building-custom-profiles/" meant in fact "https://firejail.wordpress.com/documentation-2/building-custom-profiles/"
Excerpt :

One popular customization is removing network access for media players such as VLC:
$ cat ~/.config/firejail/vlc.profile
net none
include /etc/firejail/vlc.profile
<!-- gh-comment-id:1068646414 --> @zithro commented on GitHub (Mar 16, 2022): Hey guys, thanks for the clarification, so I think the docs need an update ;) "documentation-2/building-custom-profiles/" meant in fact "https://firejail.wordpress.com/documentation-2/building-custom-profiles/" Excerpt : ``` One popular customization is removing network access for media players such as VLC: $ cat ~/.config/firejail/vlc.profile net none include /etc/firejail/vlc.profile ```
gitea-mirror commented 2026-05-05 09:31:33 -06:00
Author
Owner
Copy link

@ghost commented on GitHub (Mar 16, 2022):

[...] so I think the docs need an update

Indeed they do. All the examples in that section are inclusion loops. Not sure who actually maintains https://firejail.wordpress.com/ to correct them.

<!-- gh-comment-id:1068661207 --> @ghost commented on GitHub (Mar 16, 2022): > [...] so I think the docs need an update Indeed they do. All the examples in that section are inclusion loops. Not sure who actually maintains https://firejail.wordpress.com/ to correct them.
gitea-mirror commented 2026-05-05 09:31:34 -06:00
Author
Owner
Copy link

@zithro commented on GitHub (Mar 16, 2022):

@netblue30 is the author, look at the website comments.

<!-- gh-comment-id:1069197634 --> @zithro commented on GitHub (Mar 16, 2022): @netblue30 is the author, look at the website comments.
gitea-mirror commented 2026-05-05 09:31:34 -06:00
Author
Owner
Copy link

@rusty-snake commented on GitHub (Mar 16, 2022):

All the examples in that section are inclusion loops.

No, because the suggest to create vlc.profile not vlc.local.
FTR: Nowadays you should create a vlc.local without include /etc/firejal/vlc.profile.

<!-- gh-comment-id:1069356879 --> @rusty-snake commented on GitHub (Mar 16, 2022): > All the examples in that section are inclusion loops. No, because the suggest to create `vlc.profile` not `vlc.local`. FTR: Nowadays you should create a `vlc.local` without `include /etc/firejal/vlc.profile`.
gitea-mirror commented 2026-05-05 09:31:34 -06:00
Author
Owner
Copy link

@netblue30 commented on GitHub (Mar 24, 2022):

I wasn't aware of the .local functionality. We just need to document the difference between .local and .profile for files in ~/.config/firejail directory.

<!-- gh-comment-id:1077592659 --> @netblue30 commented on GitHub (Mar 24, 2022): I wasn't aware of the .local functionality. We just need to document the difference between .local and .profile for files in ~/.config/firejail directory.
gitea-mirror commented 2026-05-05 09:31:35 -06:00
Author
Owner
Copy link

@rusty-snake commented on GitHub (Mar 24, 2022):

FTR
https://github.com/netblue30/firejail/wiki/Creating-overrides
https://github.com/netblue30/firejail/wiki/Creating-Profiles

<!-- gh-comment-id:1077906319 --> @rusty-snake commented on GitHub (Mar 24, 2022): FTR https://github.com/netblue30/firejail/wiki/Creating-overrides https://github.com/netblue30/firejail/wiki/Creating-Profiles
gitea-mirror commented 2026-05-05 09:31:35 -06:00
Author
Owner
Copy link

@zithro commented on GitHub (Apr 7, 2022):

Should I close this issue ?
The github wiki is up-to-date but the wordpress page is still using .profile everywhere

<!-- gh-comment-id:1091822755 --> @zithro commented on GitHub (Apr 7, 2022): Should I close this issue ? The github wiki is up-to-date but the wordpress page is still using `.profile` everywhere
gitea-mirror commented 2026-05-05 09:31:36 -06:00
Author
Owner
Copy link

@rusty-snake commented on GitHub (Apr 7, 2022):

Should I close this issue ?

No

<!-- gh-comment-id:1092086804 --> @rusty-snake commented on GitHub (Apr 7, 2022): > Should I close this issue ? No
Sign in to join this conversation.
No Branch/Tag specified
Branches Tags
master
serialize_remounts_v2
landlock_v4
landlock
release-0.9.64
release-0.9.62
gitlab_ci
LTSbase
fred_ctests
docs
0.9.80
0.9.80-rc1
0.9.78
0.9.76
0.9.76-rc4
0.9.76-rc3
0.9.76-rc2
0.9.76-rc1
0.9.74
landlock-split
0.9.72
0.9.72rc1
0.9.70
0.9.68
0.9.68rc1
0.9.66
0.9.66rc1
0.9.64.4
0.9.64.2
0.9.64
0.9.64rc1
0.9.62.4
0.9.62.2
0.9.62
0.9.56.2-LTS
0.9.60
0.9.60-rc1
0.9.58.2
0.9.58
0.9.58-rc1
0.9.56-LTS-release
0.9.56-LTS
0.9.56
0.9.56-rc1
0.9.54
0.9.54-rc2
0.9.54-rc1
0.9.52
0.9.38.12
0.9.50
0.9.50-rc1
0.9.48
0.9.46
0.9.46-rc1
0.9.44.10
0.9.44.8
0.9.44.6
0.9.38.10
0.9.44.4
0.9.38.8
0.9.44.2
0.9.44
0.9.44-rc1
0.9.38.4
0.9.42
0.9.42-rc2
0.9.38.2
0.9.42-rc1
disable-globalcfg
0.9.40
0.9.40-rc1
0.9.38
0.9.38-rc1
0.9.36
0.9.36-rc1
0.9.34
0.9.34-rc1
0.9.32
0.9.32-rc1
0.9.30
0.9.30-rc1
Labels
Clear labels   
LTS merge

   
LTS merge

   
bug

   
bug

   
converted-to-discussion

   
doc-todo

   
documentation

   
duplicate

   
enhancement

   
file-transfer

   
firecfg

   
firejail-in-firejail

   
firetools

   
graphics

   
help wanted

   
information_old

   
installation

   
invalid

   
modif

   
moved

   
needinfo

   
networking

   
notabug

   
notourbug

   
old-version

   
overlayfs

   
packaging

   
profile-request

   
pull-request

Mirrored from GitHub Pull Request

  
question

   
question_old

   
removal

   
runtime-permissions

   
sandbox-ipc

   
security

   
stale

   
wiki

   
wiki

   
wontfix

   
wordpress

   
workaround
No labels
LTS merge
LTS merge
bug
bug
converted-to-discussion
doc-todo
documentation
duplicate
enhancement
file-transfer
firecfg
firejail-in-firejail
firetools
graphics
help wanted
information_old
installation
invalid
modif
moved
needinfo
networking
notabug
notourbug
old-version
overlayfs
packaging
profile-request
pull-request
question
question_old
removal
runtime-permissions
sandbox-ipc
security
stale
wiki
wiki
wontfix
wordpress
workaround
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference: github-starred/firejail#2863
No description provided.
Delete branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?