Skip to content

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

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.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Labels

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions