Skip to content

Commit 4b1cf9c

Browse files
committed
docs: update disk space check documentation for percentage-based validation
- Changed from MIN_DISK_GB to MIN_DISK_PERCENT configuration - Document 10% default scaling across different disk sizes - Add examples showing 100GB, 1TB, and 10TB scaling - Update configuration examples in dockerfile and Python - Explain automatic scaling benefits
1 parent 5e35792 commit 4b1cf9c

File tree

1 file changed

+15
-8
lines changed

1 file changed

+15
-8
lines changed

docs/serverless/worker_fitness_checks.md

Lines changed: 15 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -257,17 +257,24 @@ Memory check passed: 12.00GB available (of 16.00GB total)
257257

258258
Verifies adequate disk space on root filesystem and /tmp (common for model downloads).
259259

260-
- **Default**: 1GB minimum
261-
- **Configure**: `RUNPOD_MIN_DISK_GB=20.0`
260+
Requires free space to be at least a percentage of total disk size, which automatically scales to different machine sizes.
261+
262+
- **Default**: 10% of total disk must be free
263+
- **Configure**: `RUNPOD_MIN_DISK_PERCENT=15` (or any percentage 0-100)
262264

263265
What it checks:
264-
- Root filesystem (/) free space
265-
- Temporary directory (/tmp) free space
266-
- Disk usage percentage
266+
- Root filesystem (/) free space percentage
267+
- Temporary directory (/tmp) free space percentage
268+
- Automatic scaling based on total disk size
269+
270+
Scaling examples with 10% default:
271+
- 100GB disk: requires 10GB free
272+
- 1TB disk: requires 100GB free
273+
- 10TB disk: requires 1TB free
267274

268275
Example log output:
269276
```
270-
Disk space check passed on /: 50.00GB free (25.0% used)
277+
Disk space check passed on /: 50.00GB free (50.0% available)
271278
```
272279

273280
### Network Connectivity
@@ -353,7 +360,7 @@ All thresholds are configurable via environment variables. For example:
353360
```dockerfile
354361
# In your Dockerfile or container config
355362
ENV RUNPOD_MIN_MEMORY_GB=8.0
356-
ENV RUNPOD_MIN_DISK_GB=20.0
363+
ENV RUNPOD_MIN_DISK_PERCENT=15.0
357364
ENV RUNPOD_MIN_CUDA_VERSION=12.0
358365
ENV RUNPOD_NETWORK_CHECK_TIMEOUT=10
359366
ENV RUNPOD_GPU_BENCHMARK_TIMEOUT=2
@@ -365,7 +372,7 @@ Or in Python:
365372
import os
366373

367374
os.environ["RUNPOD_MIN_MEMORY_GB"] = "8.0"
368-
os.environ["RUNPOD_MIN_DISK_GB"] = "20.0"
375+
os.environ["RUNPOD_MIN_DISK_PERCENT"] = "15.0"
369376
```
370377

371378
## Behavior

0 commit comments

Comments
 (0)