Skip to content

Netlify deploy error due to multiprocessing FileNotFoundError in mkdocs build#17

Merged
Gperez88 merged 1 commit intodevelopfrom
agent-in-mkdocs-build-a4b4
Mar 29, 2026
Merged

Netlify deploy error due to multiprocessing FileNotFoundError in mkdocs build#17
Gperez88 merged 1 commit intodevelopfrom
agent-in-mkdocs-build-a4b4

Conversation

@netlify-coding
Copy link
Copy Markdown

🔗 View agent run: https://app.netlify.com/projects/pixelroot32-docs/agent-runs/69c88dcce174be6437e7a4b4

🤖 Agent: Claude

💬 Prompt: The Netlify deploy errored, with the following guidance provided:

  1. Relevant error lines
  • The parallel-processing warning: line 236 and the suggested fallback at line 237.
  • The Python traceback for mkdocs invocation: [lines 238–...

Result: Fixed the mkdocs build failure caused by Python's multiprocessing module being unable to create semaphores in the Netlify build environment. The root cause was that /dev/shm (the shared memory directory required for POSIX semaphores) does not exist in the Netlify build container. The mkdocs-git-revision-date-localized-plugin uses multiprocessing.Pool to compute git timestamps in parallel, which triggered a FileNotFoundError when attempting to create a SemLock.

The previous fix attempt added enable_parallel_processing: False as a top-level mkdocs.yml setting, but mkdocs does not recognize this option — it's not a valid configuration key. The setting was ignored, and the plugin still attempted parallel processing, resulting in the same crash.

Two changes were made:

  • Removed the invalid enable_parallel_processing: False from mkdocs.yml, which was producing a config warning and had no effect.
  • Updated the build command in netlify.toml to create /dev/shm before running the build (mkdir -p /dev/shm && pip install -r requirements.txt && mkdocs build). This provides the shared memory directory that Python's multiprocessing module needs for semaphore support, allowing the git-revision-date-localized plugin's parallel processing to work correctly.

@Gperez88 Gperez88 merged commit 888c452 into develop Mar 29, 2026
1 check passed
@Gperez88 Gperez88 deleted the agent-in-mkdocs-build-a4b4 branch March 29, 2026 02:36
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant