Document base URL flag for CLI

Author: bruno-espino

docs/reference/cli.md

@@ -21,7 +21,11 @@ logfire auth
 ```
 
 You will be prompted to select a [data region](./data-regions.md) (EU or US). To specify this
-via the cli instead of interactively, use `logfire --region eu auth` or `logfire --region eu auth`
+via the cli instead of interactively, use `logfire --region eu auth` or `logfire --region us auth`
+
+!!! note
+    If you're using a [self-hosted Logfire instance](./self-hosted/overview.md), you can authenticate by specifying your instance's URL using the `--base-url` flag:
+    `logfire --base-url="https://<your_logfire_hostname>" auth`
 
 Then you will be given the option to open logfire in your browser:
 ![Terminal screenshot with Logfire auth command](../images/cli/terminal-screenshot-auth-1.png)

docs/reference/self-hosted/overview.md

@@ -40,6 +40,16 @@ logfire.configure(
 )
 ```
 
+### CLI Authentication
+
+You can also authenticate with your self-hosted instance using the CLI:
+
+```bash
+logfire --base-url="https://<your_logfire_hostname>" auth
+```
+
+This will authenticate you against your self-hosted domain and store the credentials locally.
+
 ## Service Architecture
 
 The Self-hosted deployment has a number of interdependent services that work to run logfire.  Each component can be scaled independently of others depending on the utilisation of the system.

logfire/_internal/cli/__init__.py

@@ -307,7 +307,9 @@ def _main(args: list[str] | None = None) -> None:
     global_opts = parser.add_argument_group(title='global options')
     url_or_region_grp = global_opts.add_mutually_exclusive_group()
     url_or_region_grp.add_argument('--logfire-url', help=argparse.SUPPRESS)
-    url_or_region_grp.add_argument('--base-url', help=argparse.SUPPRESS)
+    url_or_region_grp.add_argument(
+        '--base-url', help='the base URL for self-hosted Logfire instances (e.g., http://localhost:8080)'
+    )
     url_or_region_grp.add_argument('--region', choices=REGIONS, help='the region to use')
     parser.set_defaults(func=lambda _: parser.print_help())  # type: ignore
     subparsers = parser.add_subparsers(title='commands', metavar='')

tests/test_cli.py

@@ -49,7 +49,7 @@ def logfire_credentials() -> LogfireCredentials:
 
 def test_no_args(capsys: pytest.CaptureFixture[str]) -> None:
     main([])
-    assert 'usage: logfire [-h] [--version] [--region {us,eu}]  ...' in capsys.readouterr().out
+    assert 'usage: logfire [-h] [--version] [--base-url BASE_URL | --region {us,eu}]  ...' in capsys.readouterr().out
 
 
 def test_version(capsys: pytest.CaptureFixture[str]) -> None: