Skip to content

docs: add Docker development performance guidance for Mac/Windows #80002

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom
Open
wants to merge 1 commit into
base: canary
Choose a base branch
from
Open

docs: add Docker development performance guidance for Mac/Windows #80002

wants to merge 1 commit into from

Conversation

devin-ai-integration[bot]
Copy link

Add Docker Development Performance Documentation

This PR adds documentation about Docker performance issues during development on Mac and Windows, based on community feedback.

Changes

  • Added section 8 to the local development performance guide explaining Docker filesystem performance issues
  • Added a development note to the Docker deployment section recommending local development for better performance
  • Provides clear guidance on when to use Docker vs local development

Context

Based on community discussion about slow HMR when using Docker for development on Mac/Windows compared to local development. Docker's filesystem access on these platforms can cause significant performance degradation.

Link to Devin run: https://app.devin.ai/sessions/7feff3a0c28c4f9ab41014fec498e00e
Requested by: [email protected]

@devin-ai-integration
docs: add Docker development performance guidance for Mac/Windows
1c9a24d 
- Add section 8 to local development guide about Docker performance issues
- Add development note to Docker deployment section
- Recommend local development over Docker on Mac/Windows for better HMR performance

Co-Authored-By: [email protected] <[email protected]>
@devin-ai-integration Devin.ai Integration
Copy link
Author

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

  • Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
  • Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

  • Disable automatic comment and CI monitoring

@ijjk ijjk added the Documentation Related to Next.js' official documentation. label May 30, 2025
@changeset-bot changeset-bot
Copy link

changeset-bot bot commented May 30, 2025

⚠️ No Changeset found

Latest commit: 1c9a24d

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@ijjk
Copy link
Member

ijjk commented May 30, 2025

Allow CI Workflow Run

  • approve CI run for commit: 1c9a24d

Note: this should only be enabled once the PR is ready to go and can only be enabled by a maintainer

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Reviewers
No reviews
Assignees
No one assigned
Labels
Documentation Related to Next.js' official documentation.
Projects
None yet
Milestone
No milestone
Development

Successfully merging this pull request may close these issues.
1 participant
@ijjk