Skip to content

03 First-Time Setup and Access

Your first access decision controls everything that follows: local frictionless testing or authenticated shared usage. Start in local mode for onboarding speed, then switch to explicit authentication before team rollout.

3.1 Prerequisites

3.2 Quick Start

Step 1: Get the Athene CLI tool

Open the Athene home page in your browser and download the CLI from there. This is the easiest path because the page gives you the right binary for your platform and keeps the install flow aligned with your running server.

For a default local Docker run, open:

http://localhost:19191

If you install Athene CLI from the native Linux Debian or RPM package, command completion is installed automatically for both Bash and Zsh (including /usr/share/zsh/vendor-completions/_athene for Zsh).

Step 2: Authenticate with the CLI

Interactive login:

athene login

Non-interactive login (good for scripts):

printf 'admin\n' | athene login --username admin --password-stdin

Step 3: Confirm access with one real command

athene ls

3.3 Optional Login Arguments

  • -O, --use-oath: forces web-based OAuth device login flow when you want browser-assisted authentication.
  • -I, --ignore-ssl-trust: bypasses TLS trust verification for self-signed lab certificates.
  • <url>: target Athene at a non-default endpoint when it is not running on localhost defaults.

Tip

  • Teams often validate in local bypass mode and forget to retest in authenticated mode. Always run at least one full auth-based CLI flow before handing the environment to CI/CD users.
  • This quick start assumes the default Docker configuration and CLI access from the same local host. If Athene runs on another machine, pass the full URL to athene login.

3.4 What You Should Have Before Chapter 04

  • A reachable Athene endpoint.
  • One known-good login path.
  • One successful CLI command proving access.
  • If you are switching authentication backends (for example to LDAP), use 12 Integrations.

Next chapter: 04 Creating Repositories.