Splunk Search

Splunk doesn't recognize searchbnf.conf

petersob
Explorer

Hi all,

I trying to implement online help for my custom search commands. There is a searchbnf.conf located in the $SPLUNK_HOME/etc/system/default directory.
If I put my configuration into that file everything is working fine, but if I create a new searchbnf.conf in my app-local directory it will not be recognized by splunk.

Is there any possibility to create the searchbnf.conf in the app context (without changing the system-wide one)?

Regards,
Peter

Tags (1)

pongc
Engager

Spoke with Splunk and got the answer.

To add permission for a specific entry within searchbnf, add

[searchbnf/<command stanza header in searchbnf.conf>]
export=system

to metadata\local.meta

To add permission for all searchbnf commands, add

[searchbnf]
export=system

to metadata\local.meta

0 Karma

pongc
Engager

Have this same issue as well. Using
splunk btool searchbnf list --debug
I do see that the app specific searchbnf stanzas are processed, though in search it does not show. It does work if I copy searchbnf.conf to etc\app\search\local so believe it is an configuration permission that needs to be applied via app specific local.meta, but cannot find information on how to define the config. In the GUI I do not see this defined as a config object within the context of the app.

0 Karma
Got questions? Get answers!

Join the Splunk Community Slack to learn, troubleshoot, and make connections with fellow Splunk practitioners in real time!

Meet up IRL or virtually!

Join Splunk User Groups to connect and learn in-person by region or remotely by topic or industry.

Get Updates on the Splunk Community!

[Puzzles] Solve, Learn, Repeat: Tiling

This puzzle (first published here) is based on finding groups of tessellated tiles (inspired by floor tiles I ...

SOK it to Me: Top 3 Benefits of Using Splunk Operator on Kubernetes that’ll Make ...

    Thursday, July 9, 2026  |  11:00AM–12:00PM PDT Duration: 1 hour (includes Q&A) Managing can feel like a ...

Upgrade Prep for 10.4, Network Observability Deep Dives, and More from Splunk Lantern

Splunk Lantern is Splunk’s customer success center that provides practical guidance from Splunk experts on key ...