> For the complete documentation index, see [llms.txt](https://docs.autonomi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.autonomi.com/developers/sdk/install/reference/daemon-command-reference.md).

# Daemon Command Reference

Reference for the `antd` command-line interface.

## Usage

### Main command

**Command:** `antd`

Runs the local REST and gRPC gateway daemon for Autonomi.

**Parameters:**

| Name                             | Type    | Required | Description                                                                                                    |
| -------------------------------- | ------- | -------- | -------------------------------------------------------------------------------------------------------------- |
| `--rest-addr <ADDR>`             | string  | No       | REST listen address, default `127.0.0.1:8082` (loopback only — pass `0.0.0.0:8082` to expose on the network)   |
| `--grpc-addr <ADDR>`             | string  | No       | gRPC listen address, default `127.0.0.1:50051` (loopback only — pass `0.0.0.0:50051` to expose on the network) |
| `--rest-port <PORT>`             | integer | No       | Override the REST port from `--rest-addr`                                                                      |
| `--grpc-port <PORT>`             | integer | No       | Override the gRPC port from `--grpc-addr`                                                                      |
| `--network <MODE>`               | string  | No       | Network mode, default `default`; also supports `local`                                                         |
| `--peers <MULTIADDRS>`           | string  | No       | Comma-separated bootstrap peer multiaddrs                                                                      |
| `--cors`                         | boolean | No       | Enable localhost CORS headers                                                                                  |
| `--log-level <LEVEL>`            | string  | No       | Log level: `trace`, `debug`, `info`, `warn`, `error`                                                           |
| `--quote-timeout-secs <SECONDS>` | integer | No       | Override the quote and DHT timeout for lightweight network operations                                          |
| `--store-timeout-secs <SECONDS>` | integer | No       | Override the timeout for chunk store and retrieve operations                                                   |
| `--quote-concurrency <COUNT>`    | integer | No       | Override quote and DHT lookup concurrency                                                                      |
| `--store-concurrency <COUNT>`    | integer | No       | Override chunk-store concurrency                                                                               |

**Environment variables:**

| Variable                    | Description                                |
| --------------------------- | ------------------------------------------ |
| `ANTD_REST_ADDR`            | REST listen address                        |
| `ANTD_GRPC_ADDR`            | gRPC listen address                        |
| `ANTD_REST_PORT`            | REST port override                         |
| `ANTD_GRPC_PORT`            | gRPC port override                         |
| `ANTD_NETWORK`              | Network mode                               |
| `ANTD_PEERS`                | Comma-separated bootstrap peer multiaddrs  |
| `ANTD_CORS`                 | Enable CORS                                |
| `ANTD_LOG_LEVEL`            | Log level                                  |
| `ANTD_QUOTE_TIMEOUT_SECS`   | Quote and DHT timeout override             |
| `ANTD_STORE_TIMEOUT_SECS`   | Chunk store and retrieve timeout override  |
| `ANTD_QUOTE_CONCURRENCY`    | Quote and DHT concurrency override         |
| `ANTD_STORE_CONCURRENCY`    | Chunk-store concurrency override           |
| `AUTONOMI_WALLET_KEY`       | Direct-wallet private key for paid uploads |
| `EVM_RPC_URL`               | EVM RPC endpoint                           |
| `EVM_PAYMENT_TOKEN_ADDRESS` | Payment token contract                     |
| `EVM_PAYMENT_VAULT_ADDRESS` | Payment vault contract                     |

**Examples:**

```bash
# Default network, default ports
antd

# Local network with explicit peers
ANTD_PEERS="/ip4/127.0.0.1/udp/12000/quic-v1/p2p/12D3Koo..." antd --network local

# Expose on all network interfaces (opt in deliberately — antd has no auth)
antd --rest-addr 0.0.0.0:8082 --grpc-addr 0.0.0.0:50051

# Let the OS assign free ports
antd --rest-port 0 --grpc-port 0

# Run with debug logging
antd --log-level debug

# Tune quote and store behavior for slower networks
antd --quote-timeout-secs 15 --store-timeout-secs 90 --quote-concurrency 32 --store-concurrency 8
```

**Response:** None. The daemon keeps running until it is stopped.

## Notes

* The CLI does not include an `--external-signer` flag.
* External-signer mode is handled through environment configuration and the prepare/finalize upload endpoints.
* Use `EVM_PAYMENT_VAULT_ADDRESS` for current paid-write and external-signer setups.
* On startup, `antd` writes a `daemon.port` file under the SDK data directory so SDKs can discover the active ports.

## Error codes

| Code                         | Meaning                                           | Resolution                                   |
| ---------------------------- | ------------------------------------------------- | -------------------------------------------- |
| invalid REST address         | `--rest-addr` could not be parsed                 | Fix the host:port value                      |
| invalid gRPC address         | `--grpc-addr` could not be parsed                 | Fix the host:port value                      |
| runtime wallet/config errors | Required env vars are missing for paid operations | Set the wallet and EVM environment variables |

## Related pages

* [Build with the SDKs](/developers/sdk/install.md)
* [Start the Local Daemon](/developers/sdk/install/start-the-local-daemon.md)
* [Use the Daemon as a Local Service](/developers/sdk/install/how-to-guides/use-the-daemon-as-a-local-service.md)
* [REST API](/developers/sdk/install/reference/rest-api.md)
