# [daemon]

<!-- Generated by web/apps/docs/scripts/gen-reference.ts from the Atuin source. Do not edit. -->

The background daemon, which can record history and sync in place of each shell.

## `daemon.enabled`

Send history and sync through the daemon, rather than from each shell.
`atuin setup --only --daemon` turns it on, with `autostart` and the `daemon-fuzzy`
`search_mode`.

- **Type:** boolean
- **Default:** `false`

## `daemon.autostart`

Start the daemon whenever a command needs it. It doesn't work with `systemd_socket`.

- **Type:** boolean
- **Default:** `false`

## `daemon.sync_frequency`

How often the daemon syncs, such as `5m`. `0` turns periodic sync off.

- **Type:** string or number
- **Default:** `"5m"`

## `daemon.socket_path`

The Unix socket that clients reach the daemon through. If unset,
`$TMPDIR/atuin-$UID/atuin.sock`, or `$XDG_RUNTIME_DIR/atuin.sock` with `systemd_socket`.

The default doesn't depend on `ATUIN_HOME`. Give each `ATUIN_HOME` whose daemon runs at the
same time a socket of its own.

- **Type:** string
- **Default:** `unset`

## `daemon.pidfile_path`

The daemon's pidfile, which processes coordinate through.

- **Type:** string
- **Default:** `"~/.atuin/data/atuin-daemon.pid"`

## `daemon.systemd_socket`

Listen on the socket that systemd's socket activation passes, rather than on
`socket_path`.

- **Type:** boolean
- **Default:** `false`

## `daemon.tcp_port`

The TCP port that clients reach the daemon through, on systems without Unix sockets.

- **Type:** integer
- **Default:** `8889`