docs: add sync-state troubleshooting guide to README#1050
Open
mehmetkr-31 wants to merge 1 commit intobase:mainfrom
Open
docs: add sync-state troubleshooting guide to README#1050mehmetkr-31 wants to merge 1 commit intobase:mainfrom
mehmetkr-31 wants to merge 1 commit intobase:mainfrom
Conversation
The Troubleshooting section only contained a Discord link. New operators frequently report AwaitingELSyncCompletion as a bug (see issue base#1041) and are confused when the consensus client repeatedly logs that it is skipping derivation. Add a dedicated troubleshooting guide covering: - AwaitingELSyncCompletion: explain that it is expected during initial sync, not an error, and list resolution steps. - EL/CL connection issues: checklist for Docker network, auth-RPC port, and JWT secret alignment. - Docker daemon restart: guidance on verifying container state and the role of supervisord autorestart. This reduces support burden and improves the first-run experience.
Collaborator
🟡 Heimdall Review Status
|
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
2 participants
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.
Summary
Expands the Troubleshooting section from a single Discord link into a practical guide for the three most common operator issues.
Problem
#🛠｜node-operatorsshow that new operators repeatedly mistakeAwaitingELSyncCompletionfor a fatal error.Solution
Add three subsections under Troubleshooting:
AwaitingELSyncCompletionin consensus client logs — explains that this is expected during initial sync, lists resolution steps (wait, checketh_syncing, verify engine RPC endpoint).8551), and JWT secret alignment.docker ps,docker logs, and the role ofautorestart=trueinsupervisord.conf.Impact
Checklist