Add ReadMe troubleshooting section for network start issues#1356
Open
mitnick2012 wants to merge 1 commit into
Open
Add ReadMe troubleshooting section for network start issues#1356mitnick2012 wants to merge 1 commit into
mitnick2012 wants to merge 1 commit into
Conversation
Added troubleshooting section for 'icp network start' error.
|
Dear @mitnick2012, In order to potentially merge your code in this open-source repository and therefore proceed with your contribution, we need to have your approval on DFINITY's CLA. If you decide to agree with it, please visit this issue and read the instructions there. Once you have signed it, re-trigger the workflow on this PR to see if your code can be merged. — The DFINITY Foundation |
Member
|
@mitnick2012 thanks for the contribution. I forwarded the issue to the team as I think it's better to fix the feedback in the icp-cli directly instead of documenting the problem across the board. |
Author
|
Yes its better to fix in the cli,and I suggest to let the fix of the problem here |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Overview
When
icp network startexits with status 101, the terminal output gives noactionable information. The actual error (e.g. port conflict) is silently written
to a log file that new users have no reason to know exists. This leaves developers
stuck with a cryptic error and no clear path to resolution.
Requirements
icp network start -drunning successfullyConsidered Solutions
instead of just reporting exit status 101 — this would be the ideal long-term fix
but requires changes to the network launcher itself.
immediately — low effort, high impact, no code changes required.
Recommended Solution
Option 2 — documentation. It unblocks users today without touching any code.
The log file path and the port conflict error message are stable and reliable
signals, making them safe to document. Option 1 is worth a separate issue/PR
targeting the CLI itself.
Considerations
a faster path to resolution instead of hitting a dead end.
are unlikely to change frequently. If the default port ever changes, this
section will need a one-line update.