---
name: "oidc-agent-service"
section: "1"
platform: "linux"
package: "oidc-agent-cli"
version: "4.2.6-1.1+b1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/oidc-agent-service"
---

# oidc-agent-service(1)

easily restart oidc-agent throughout a session

## NAME

oidc-agent-service - easily restart oidc-agent throughout a session

## SYNOPSIS

**oidc-agent-service** *use \| start \| restart \| restart-s \| stop \| kill*

## DESCRIPTION

oidc-agent-service **--** Easily restart oidc-agent

-

  Commands:

- use

  Starts the agent, if agent is already running, reuses that agent

- start

  Starts the agent, fails if agent is already running

- restart

  Restarts the agent

- restart-s

  Restarts the agent, but does not print any output

- stop

  Stops the agent

- kill

  Stops the agent

## FILES

/tmp/oidc-agent-service/$UID/oidc-agent.pid

oidc-agent-service creates a symlink from this file to tha active agent's socket. The symlink is updated when the agent is restarted.

/etc/oidc-agent/oidc-agent-service.options

This file contains options to configure the behavior of oidc-agent-service, e.g. it can be used to configure the command line options with which the agent should be started. It is also used to disable Xsession integration.

$OIDCAGENTDIR/oidc-agent-service.options

User-space version of **/etc/oidc-agent/oidc-agent-service.options**. Any value specified in this file overwrite the value defined in the global version.

## EXAMPLES

```
eval `oidc-agent-service use`
```

Starts the agent

```
eval `oidc-agent-service stop`
```

Stops the agent

```
eval `oidc-agent-service restart`
```

Restarts the agent

```
oidc-agent-service restart-s
```

Restarts the agent without printing any information (silent mode).

## SEE ALSO

[oidc-agent(1)](/oidc-agent/1.md)

Low-traffic mailing list with updates such as critical security incidents and new releases: https://www.lists.kit.edu/sympa/subscribe/oidc-agent-user

Full documentation can be found at https://indigo-dc.gitbooks.io/oidc-agent/user/oidc-agent-service