glab(1)

✨ glab-ssh-key-add ✨

okay so real quick — this is a page from glab(1), the GitLab CLI manual, and today's main character is the ssh-key add command. buckle up bestie 🎀

---

🌸 NAME 🌸

glab-ssh-key-add — literally just: add an SSH key to your GitLab account. that's the whole vibe. 🔑

---

🦋 SYNOPSIS 🦋

glab ssh-key add [key-file] [flags]

---

💜 DESCRIPTION 💜

So what it does is it creates a new SSH key that's owned by whoever you're currently authenticated as. main character energy, but make it cryptographic. 🔐

Heads up though — it requires the --title flag. no title, no key, no cap.

Also important, and GitLab is kinda strict about this: GitLab rejects a key whose fingerprint is already registered on your account — even when that key has expired. expired and still blocked, the disrespect 😭. so if you wanna re-register it, use --replace to delete the existing key with the same SHA256 fingerprint and add it again, this time with the new title, usage type, and expiration date. slay, fresh start. ✨

---

💅 OPTIONS 💅

• -e, --expires-at="" — the expiration date of the SSH key. it uses ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ. put it on the calendar bestie 🗓️
• --replace[=false] — delete an existing key with the same fingerprint (like, say, an expired one) before adding this one. bye felicia 👋
• -t, --title="" — the new SSH key's title. required, remember? don't forget it 🙈
• -u, --usage-type="auth_and_signing" — the usage scope for the key. possible values are auth, signing or auth_and_signing. the default value is auth_and_signing. pick your fighter 🫶

---

🧚 OPTIONS INHERITED FROM PARENT COMMANDS 🧚

• -h, --help[=false] — show help for this command. when in doubt, ask for help, that's growth 💖
• -R, --repo="" — select another repository. you can use either OWNER/REPO or GROUP/NAMESPACE/REPO, and the full URL or Git URL is also accepted. flexible icon 🌈

---

🔥 EXAMPLE 🔥

# Read ssh key from stdin and upload.
glab ssh-key add -t "my title"

# Read ssh key from specified key file, upload and set the ssh key type to "authentication".
glab ssh-key add ~/.ssh/id_ed25519.pub -t "my title" --usage-type "auth"

# Re-register an expired key with a new expiration date.
glab ssh-key add ~/.ssh/id_ed25519.pub -t "my title" --expires-at 2027-01-01 --replace

---

👑 SEE ALSO 👑

• glab-ssh-key(1) — the whole ssh-key family, go say hi 💫

---

ngl that's the whole page. go add that key, you've got this 💪

---

mwah 💋 — this page was Auto generated by spf13/cobra, dated Nov 2026, and it lives in the glab(1) manual. that's the tea, periodt. 🍓