fix(docs) add blank line before fenced code block in server config
- commit
- 8ddd497c2b58ead7e97a3e059172d68ff1043c32
- author
- bnema · · 2026-02-06 20:43 UTC
- parent
- e8e1134
- signature
- GPG Verified
CD88F9E564E0102646FB6077A1A07C7C7C3E349D· arch-gpg Verified for the committer email
1 file · +4 -3
M docs/config/server.md +4 -3
| @@ -22,7 +22,7 @@ gordon_domain = "gordon.mydomain.com" # Gordon domain (required) | |||
| 22 | 22 | | `registry_domain` | string | - | Deprecated alias for `gordon_domain` | | |
| 23 | 23 | | `data_dir` | string | `~/.gordon` | Directory for registry data, logs, and env files | | |
| 24 | 24 | | `max_proxy_body_size` | string | `"512MB"` | Maximum request body size for proxied requests | | |
| 25 | - | | `max_blob_chunk_size` | string | `"512MB"` | Maximum request body size for a single registry blob upload chunk | | |
| 25 | + | | `max_blob_chunk_size` | string | `"95MB"` | Maximum request body size for a single registry blob upload chunk | | |
| 26 | 26 | ||
| 27 | 27 | ## Port Configuration | |
| 28 | 28 | ||
| @@ -147,7 +147,7 @@ The `max_blob_chunk_size` setting limits the size of a single blob upload reques | |||
| 147 | 147 | ||
| 148 | 148 | ```toml | |
| 149 | 149 | [server] | |
| 150 | - | max_blob_chunk_size = "512MB" # Default | |
| 150 | + | max_blob_chunk_size = "95MB" # Default | |
| 151 | 151 | ``` | |
| 152 | 152 | ||
| 153 | 153 | **Purpose:** Prevents excessive memory usage during blob uploads while allowing large real-world image layers. | |
| @@ -155,6 +155,7 @@ max_blob_chunk_size = "512MB" # Default | |||
| 155 | 155 | **Supported units:** B, KB, MB, GB, TB (case-insensitive, decimal/1024-based) | |
| 156 | 156 | ||
| 157 | 157 | **Examples:** | |
| 158 | + | ||
| 158 | 159 | ```toml | |
| 159 | 160 | max_blob_chunk_size = "256MB" # Stricter limit | |
| 160 | 161 | max_blob_chunk_size = "1GB" # Allow larger layers | |
| @@ -163,7 +164,7 @@ max_blob_chunk_size = "1GB" # Allow larger layers | |||
| 163 | 164 | **Behavior:** | |
| 164 | 165 | - When a blob chunk exceeds the limit, Gordon returns `413 Request Entity Too Large` | |
| 165 | 166 | - Docker/Podman may send a full layer in one request, so set this high enough for your base images | |
| 166 | - | - Default (`512MB`) supports common large base layers (for example, `postgres`) | |
| 167 | + | - Default (`95MB`) is compatible with Cloudflare and most CDN proxies; increase if pushing very large layers directly | |
| 167 | 168 | ||
| 168 | 169 | ## Examples | |
| 169 | 170 | ||
| @@ -22,7 +22,7 @@ gordon_domain = "gordon.mydomain.com" # Gordon domain (required) | |||||
| 22 | | `registry_domain` | string | - | Deprecated alias for `gordon_domain` | | 22 | | `registry_domain` | string | - | Deprecated alias for `gordon_domain` | | ||
| 23 | | `data_dir` | string | `~/.gordon` | Directory for registry data, logs, and env files | | 23 | | `data_dir` | string | `~/.gordon` | Directory for registry data, logs, and env files | | ||
| 24 | | `max_proxy_body_size` | string | `"512MB"` | Maximum request body size for proxied requests | | 24 | | `max_proxy_body_size` | string | `"512MB"` | Maximum request body size for proxied requests | | ||
| 25 | - | | `max_blob_chunk_size` | string | `"512MB"` | Maximum request body size for a single registry blob upload chunk | | 25 | + | | `max_blob_chunk_size` | string | `"95MB"` | Maximum request body size for a single registry blob upload chunk | |
| 26 | 26 | ||||
| 27 | ## Port Configuration | 27 | ## Port Configuration | ||
| 28 | 28 | ||||
| @@ -147,7 +147,7 @@ The `max_blob_chunk_size` setting limits the size of a single blob upload reques | |||||
| 147 | 147 | ||||
| 148 | ```toml | 148 | ```toml | ||
| 149 | [server] | 149 | [server] | ||
| 150 | - | max_blob_chunk_size = "512MB" # Default | 150 | + | max_blob_chunk_size = "95MB" # Default |
| 151 | ``` | 151 | ``` | ||
| 152 | 152 | ||||
| 153 | **Purpose:** Prevents excessive memory usage during blob uploads while allowing large real-world image layers. | 153 | **Purpose:** Prevents excessive memory usage during blob uploads while allowing large real-world image layers. | ||
| @@ -155,6 +155,7 @@ max_blob_chunk_size = "512MB" # Default | |||||
| 155 | **Supported units:** B, KB, MB, GB, TB (case-insensitive, decimal/1024-based) | 155 | **Supported units:** B, KB, MB, GB, TB (case-insensitive, decimal/1024-based) | ||
| 156 | 156 | ||||
| 157 | **Examples:** | 157 | **Examples:** | ||
| 158 | + | ||||
| 158 | ```toml | 159 | ```toml | ||
| 159 | max_blob_chunk_size = "256MB" # Stricter limit | 160 | max_blob_chunk_size = "256MB" # Stricter limit | ||
| 160 | max_blob_chunk_size = "1GB" # Allow larger layers | 161 | max_blob_chunk_size = "1GB" # Allow larger layers | ||
| @@ -163,7 +164,7 @@ max_blob_chunk_size = "1GB" # Allow larger layers | |||||
| 163 | **Behavior:** | 164 | **Behavior:** | ||
| 164 | - When a blob chunk exceeds the limit, Gordon returns `413 Request Entity Too Large` | 165 | - When a blob chunk exceeds the limit, Gordon returns `413 Request Entity Too Large` | ||
| 165 | - Docker/Podman may send a full layer in one request, so set this high enough for your base images | 166 | - Docker/Podman may send a full layer in one request, so set this high enough for your base images | ||
| 166 | - | - Default (`512MB`) supports common large base layers (for example, `postgres`) | 167 | + | - Default (`95MB`) is compatible with Cloudflare and most CDN proxies; increase if pushing very large layers directly |
| 167 | 168 | ||||
| 168 | ## Examples | 169 | ## Examples | ||
| 169 | 170 | ||||