Scope

• Authenticate to a Forgejo host and verify access.

• Run common issue/PR/repo commands with the correct host.

• Troubleshoot host and login mismatches.

Prerequisites

• A Forgejo Personal Access Token (PAT) created in the Forgejo web UI.

• fj installed and available in PATH.

• Optional: secret-tool (GNOME Keyring) for secure token storage.

Host usage (important)

-H/--host is a global option and must be placed before subcommands.

fj -H <FORGEJO_HOST> repo view <owner>/<repo>

To avoid repeating the host, set FJ_HOST :

export FJ_HOST=<FORGEJO_HOST>

Authentication (secret-tool example)

Store your token (one-time) and register with fj:

echo -n "<PAT_VALUE>" | secret-tool store --label="Forgejo PAT" service forgejo user <username>@<FORGEJO_HOST> echo -n "$(secret-tool lookup service forgejo user <username>@<FORGEJO_HOST>)" | fj -H <FORGEJO_HOST> auth add-key <username>

Verify:

fj -H <FORGEJO_HOST> auth list fj -H <FORGEJO_HOST> whoami

Cleanup

fj auth logout <FORGEJO_HOST> secret-tool clear service forgejo user <username>@<FORGEJO_HOST>

Troubleshooting

• Error: not logged in often means the host defaulted to github.com; add -H or set FJ_HOST .

• If secret-tool lookup returns nothing, unlock your keyring or confirm the stored user/host key.