Add ReadMe troubleshooting section for network start issues - #1356
Add ReadMe troubleshooting section for network start issues#1356mitnick2012 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 |
|
@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. |
|
Yes its better to fix in the cli,and I suggest to let the fix of the problem here |
|
@mitnick2012 this should we solved in the latest icp-cli version: https://github.com/dfinity/icp-cli/releases/tag/v1.3.0 if you still experience this, please file an issue here |
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.