Skip to content

Commit 9ad00bc

Browse files
author
Ignacio Van Droogenbroeck
committed
docs: Add max_payload_size configuration option
- Document server.max_payload_size config (default: 1GB) - Add environment variable ARC_SERVER_MAX_PAYLOAD_SIZE - Note availability in v26.01.1 - Include tip for handling large bulk imports
1 parent 28cad97 commit 9ad00bc

1 file changed

Lines changed: 29 additions & 0 deletions

File tree

docs/configuration/overview.md

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -79,6 +79,7 @@ ARC_SERVER_PORT=8000
7979
ARC_SERVER_TLS_ENABLED=false
8080
ARC_SERVER_TLS_CERT_FILE=/path/to/cert.pem
8181
ARC_SERVER_TLS_KEY_FILE=/path/to/key.pem
82+
ARC_SERVER_MAX_PAYLOAD_SIZE=1GB # v26.01.1+
8283

8384
# Logging
8485
ARC_LOG_LEVEL=info
@@ -263,6 +264,34 @@ When TLS is enabled, Arc automatically:
263264
- Adds the `Strict-Transport-Security` (HSTS) header
264265
- Validates certificate and key files on startup
265266

267+
### Max Payload Size
268+
269+
:::note Available in v26.01.1
270+
This configuration option is available starting from Arc v26.01.1.
271+
:::
272+
273+
Configure the maximum request payload size for write endpoints (msgpack, line protocol):
274+
275+
```toml
276+
[server]
277+
# Maximum payload size (applies to both compressed and decompressed)
278+
# Supports units: B, KB, MB, GB
279+
# Default: 1GB
280+
max_payload_size = "1GB"
281+
```
282+
283+
Environment variable:
284+
285+
```bash
286+
ARC_SERVER_MAX_PAYLOAD_SIZE=2GB
287+
```
288+
289+
:::tip Large Bulk Imports
290+
If you're importing large datasets and encounter 413 errors, you can:
291+
1. Increase `max_payload_size` (e.g., `"2GB"`)
292+
2. Batch your imports into smaller chunks (recommended for reliability)
293+
:::
294+
266295
### Database (DuckDB)
267296

268297
DuckDB connection pool and resource settings:

0 commit comments

Comments
 (0)