# 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)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.autonomi.com/developers/sdk/install/reference/daemon-command-reference.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.