> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gethandshake.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Configure the service

> Install, remove, and check the Handshake login service on macOS and Linux.

Handshake uses a login service to start the daemon when you sign in.

| System | Service manager      |
| ------ | -------------------- |
| macOS  | launchd              |
| Linux  | systemd user service |

## Install the service

Run:

```bash theme={null}
handshake install-service
```

The service starts `handshake serve`.

## Remove the service

Run:

```bash theme={null}
handshake uninstall-service
```

This command removes the login service. It does not remove agent
registrations or session data.

## Start the daemon without a service

Run:

```bash theme={null}
handshake serve
```

The command stays active in the current terminal.

## Service files

| System | File                                               |
| ------ | -------------------------------------------------- |
| macOS  | `~/Library/LaunchAgents/com.handshake.serve.plist` |
| Linux  | `~/.config/systemd/user/handshake.service`         |

The service file contains the resolved `HANDSHAKE_ADDR` and `HANDSHAKE_URL`
values. Run `handshake setup` after you change the address or port. Setup
updates the service and agent registrations.