agama-auth(1)

💅 agama-auth(1) — the group chat version

okay so bestie, you're looking at agama-auth(1), which lives in the General Commands Manual and is straight up about authenticating with Agama's server. yeah. that's the whole vibe. let's get into it ✨

🌸 NAME

agama-auth — authenticate with Agama's server 🫶

🎀 SYNOPSIS

agama auth [-h|--help] <subcommands>

🦋 DESCRIPTION

So. Authenticate with Agama's server. That's it, that's the mission 💅

Unless you're running this program as root, you literally need to authenticate with Agama's server for most operations. not me stating the obvious but it's true. You can log in by specifying the root password through the "auth login" command. Upon successful authentication, the server returns a JSON Web Token (JWT) which is stored to authenticate the following requests. slay, tokens, we love a credential glow-up 👑

If you run this program as root, you can skip the authentication step entirely because it automatically uses the master token at /run/agama/token. Only the root user must have access to such a file. like, do not let anyone else touch it, fr fr 🙈

You can logout at any time by using the "auth logout" command, although this command does not affect the root user. root stays logged in. root is the main character, obviously 💀

⭐ OPTIONS

• -h, --help — print help (see a summary with -h) 💖

👑 SUBCOMMANDS

• agama-auth-login(1) — authenticate with Agama's server and store the token 🔥
• agama-auth-logout(1) — deauthenticate by removing the token 🌈
• agama-auth-show(1) — print the used token to the standard output 👀

ngl bestie, if you're root just skip all of this — your token is already at /run/agama/token and it's giving "I don't wait in line" energy 💅

and that's the page!! this one came from the auth source, filed under agama-auth(1) — go off and authenticate, icon 🧚💜