brave-browser(1)

📦 version 1.98.63, in nixos 26.05, nixpkgs unstable

🎀 NAME 🎀

okay bestie, welcome to brave-browser(1) — the manual page for Brave Browser. It lives under USER COMMANDS, and it’s literally just the invocation/environment/arguments tea. 💖

✨ SYNOPSIS ✨

brave-browser [OPTION] [PATH|URL]

🦋 DESCRIPTION 🦋

Need help actually using the browser? Run, don’t walk, to the Brave Help Center: https://support.brave.app/

This manpage only describes invocation, environment, and arguments. That’s it, that’s the whole assignment. 🎀

💅 OPTIONS 💅

So Brave Web Browser has hundreds of undocumented command-line flags that get added and removed at the whim of the developers. Here, we document the relatively stable ones. Slay for stability. ✨

  • --user-data-dir=DIR — specifies the directory where user data (your “profile”) is kept. Defaults to $HOME/.config/brave-browser. Separate instances of Brave Web Browser must use separate user data directories; repeated invocations of brave-browser will reuse an existing process for a given user data directory. 💾
  • --app=URL — runs URL in “app mode”: with no browser toolbars. Main-character app energy only. 👑
  • --incognito — open in incognito mode. 🕶️
  • --new-window — if PATH or URL is given, open it in a new window. Fresh window, fresh vibe. 🪟
  • --proxy-server=host:port — specify the HTTP/SOCKS4/SOCKS5 proxy server to use for requests. This overrides any environment variables or settings picked via the options dialog. An individual proxy server is specified using the format:
[<proxy-scheme>://]<proxy-host>[:<proxy-port>]

Where <proxy-scheme> is the protocol of the proxy server, and is one of:

"http", "socks", "socks4", "socks5".

If the <proxy-scheme> is omitted, it defaults to "http". Also note that "socks" is equivalent to "socks5". 🧦

Examples:

  • --proxy-server="foopy:99" — use the HTTP proxy "foopy:99" to load all URLs.
  • --proxy-server="socks://foobar:1080" — use the SOCKS v5 proxy "foobar:1080" to load all URLs.
  • --proxy-server="socks4://foobar:1080" — use the SOCKS v4 proxy "foobar:1080" to load all URLs.
  • --proxy-server="socks5://foobar:66" — use the SOCKS v5 proxy "foobar:66" to load all URLs.

It is also possible to specify a separate proxy server for different URL types, by prefixing the proxy server specifier with a URL specifier:

Example:

  • --proxy-server="https=proxy1:80;http=socks4://baz:1080" — load https://* URLs using the HTTP proxy "proxy1:80". And load http://* URLs using the SOCKS v4 proxy "baz:1080".
  • --no-proxy-server — disables the proxy server. Overrides any environment variables or settings picked via the options dialog. No proxy, no problems. 🚫
  • --proxy-auto-detect — autodetect proxy configuration. Overrides any environment variables or settings picked via the options dialog. Let the browser sleuth it out. 🔍
  • --proxy-pac-url=URL — specify proxy autoconfiguration URL. Overrides any environment variables or settings picked via the options dialog. PAC URL said what it said. 📜
  • --password-store=<basic|gnome|kwallet> — set the password store to use. The default is to automatically detect based on the desktop environment. basic selects the built in, unencrypted password store. gnome selects Gnome keyring. kwallet selects (KDE) KWallet. (Note that KWallet may not work reliably outside KDE.) 🔐
  • --version — show version information. Iconic. 💫

As a GTK+ app, Brave Web Browser also obeys GTK+ command-line flags, such as --display. See the GTK documentation for more:

http://library.gnome.org/devel/gtk/stable/gtk-running.html
http://library.gnome.org/devel/gtk/stable/gtk-x11.html

🌈 ENVIRONMENT 🌈

Brave Web Browser obeys these environment variables, bestie: 🌸

  • all_proxy — shorthand for specifying all of http_proxy, https_proxy, ftp_proxy. One variable to rule them all. 💖
  • http_proxy, https_proxy, ftp_proxy — the proxy servers used for HTTP, HTTPS, and FTP. Note: because Gnome/KDE proxy settings may propagate into these variables in some terminals, this variable is ignored (in preference for actual system proxy settings) when running under Gnome or KDE. Use the command-line flags to set these when you want to force their values. 🫶
  • auto_proxy — specify proxy autoconfiguration. Defined and empty autodetects; otherwise, it should be an autoconfig URL. But see above note about Gnome/KDE. 🪄
  • SOCKS_SERVER — SOCKS proxy server (defaults to SOCKS v4, also set SOCKS_VERSION=5 to use SOCKS v5). Socks on, bestie. 🧦
  • no_proxy — comma separated list of hosts or patterns to bypass proxying. The “not today” list. 🙅‍♀️

🎀 FILES 🎀

💀 BUGS 💀

Bug tracker:

https://github.com/brave/brave-browser/issues/

Be sure to do your search within "All Issues" before reporting bugs, and be sure to pick the "Defect on Linux" template when filing a new one. Do the search first, bestie — the issue might already be living there. 😭

👑 AUTHOR 👑

Brave Software — https://brave.com/ 💜

Sign-off tea: this was brave-browser(1) from the USER COMMANDS section, and the footer only repeats brave-browser(1) — no extra version/date line in the source, so that’s the whole tail. byeeee 💖🎀✨

📦 where this page comes from