---
name: "yubikey-agent"
section: "1"
platform: "linux"
package: "yubikey-agent"
version: "0.1.4-2+b19"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/yubikey-agent"
---

# yubikey-agent(1)

a seamless ssh-agent for YubiKeys

## NAME

yubikey-agent - a seamless ssh-agent for YubiKeys

## CONFIGURATION

- To start yubikey-agent automatically, enable its service using:

  -

  **systemctl --user enable yubikey-service.user**

- To start yubikey-agent once, start its service using:

  -

  **systemctl --user start yubikey-service.user**

- You must also set the **$SSH\_AUTH\_SOCK** variable to **"$XDG\_RUNTIME\_DIR/yubikey-agent/yubikey-agent.sock"**.

  - In bash, this can be done by running the following command before your first use of yubikey-agent:

  -

  **echo 'export SSH\_AUTH\_SOCK="$XDG\_RUNTIME\_DIR/yubikey-agent/yubikey-agent.sock"' \>\> ~/.bashrc**

## DESCRIPTION

**yubikey-agent** \[options\] *command* \[arguments\]

### OPTIONS

- **-setup**

  -

  Generate a new SSH key on the attached YubiKey.

- **-l** PATH

  -

  Run the agent, listening on the UNIX socket at PATH.