Skip to content

[REQUEST] Add Linux-specific troubleshooting documentation for Docker DNS issues #396

@YashIIT0909

Description

@YashIIT0909

Pledge
N/A

Is your feature request related to a problem? Please describe.
Currently, there is a lack of documentation regarding common Linux networking hurdles encountered during the nostream setup. Users on rolling-release distributions or those utilizing systemd-resolved may encounter build timeouts that are not immediately obvious to resolve without resorting to non-portable workarounds.

Describe the solution you'd like
Add a "Troubleshooting" section to the README.md. This section should detail how to resolve EAI_AGAIN or DNS resolution failures by configuring the Docker daemon DNS via /etc/docker/daemon.json. Providing these instructions ensures a smoother onboarding process for contributors.

Describe alternatives you've considered
None. Documentation is the standard approach for addressing environment-specific configurations that fall outside the scope of the project's primary source code.

Additional context
This follows the implementation of a pre-flight check in the startup scripts to ensure a consistent setup experience for all contributors.

Metadata

Metadata

Labels

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions