WorkerSettings reference

Runtime policy, environment variables, defaults, and validation.

WorkerSettings contains validated runtime policy for one worker deployment.

from modal_devin import WorkerSettings

Common settings

Field	Type	Default	Use
scheduler_interval_seconds	int	3	How often the generated schedule checks for work
session_timeout_seconds	int	43200	Maximum Devin worker duration
snapshot_ttl_seconds	int | None	2592000	Retention for a resumable workspace; None is indefinite
log_level	str	"INFO"	modal_devin.worker log detail

Advanced recovery settings

Change these only for a diagnosed deployment or with support guidance:

Field	Type	Default	Use
api_timeout_seconds	float	30.0	Per-request timeout for Devin APIs
status_attempts	int	3	Final-state lookup attempts
status_retry_delay_seconds	float	1.0	Base delay between final-state attempts
status_watchdog_interval_seconds	float	60.0	How often a running worker confirms its session is still live
session_attach_timeout_seconds	float	120.0	How long a gateway-connected worker waits for Devin to attach before reconnecting fresh
sandbox_ready_timeout_seconds	int	120	Maximum Sandbox startup wait
snapshot_timeout_seconds	int	120	Maximum filesystem preservation time
claim_connect_margin_seconds	int	15	Time reserved for the worker to connect before its claim deadline

Environment variables

WorkerSettings.from_env() reads:

Environment variable	Default
MODAL_DEVIN_SCHEDULER_INTERVAL_SECONDS	30
MODAL_DEVIN_SESSION_TIMEOUT_SECONDS	43200
MODAL_DEVIN_SNAPSHOT_TTL_SECONDS	2592000
MODAL_DEVIN_LOG_LEVEL	INFO
MODAL_DEVIN_API_TIMEOUT_SECONDS	30.0
MODAL_DEVIN_STATUS_ATTEMPTS	3
MODAL_DEVIN_STATUS_RETRY_DELAY_SECONDS	1.0
MODAL_DEVIN_STATUS_WATCHDOG_INTERVAL_SECONDS	60.0
MODAL_DEVIN_SESSION_ATTACH_TIMEOUT_SECONDS	120.0
MODAL_DEVIN_SANDBOX_READY_TIMEOUT_SECONDS	120
MODAL_DEVIN_SNAPSHOT_TIMEOUT_SECONDS	120
MODAL_DEVIN_CLAIM_CONNECT_MARGIN_SECONDS	15

For snapshot retention, none and null mean indefinite retention. Names are exact; unrecognized MODAL_DEVIN_* variables are ignored.

Validation

Durations, counts, and timeouts must be positive, except that status retry delay may be zero and snapshot retention may be None. Log level is case-insensitive and accepts CRITICAL, ERROR, WARNING, INFO, or DEBUG.

Invalid values raise ConfigurationError during application startup.

Derived function timeout

worker.session_function_timeout_seconds provides the minimum function duration needed for the configured worker run plus startup, final-state handling, filesystem preservation, and cleanup. Use the property in the generated decorator instead of copying a numeric value.