Choose the symptom, not the technology you think caused it.
Access And Authentication#
- Cannot open the private onboarding repository: ask the onboarding owner to check your GitHub username, organization invitation, and team membership.
- GitHub clone asks repeatedly for credentials: use the authentication section of the Git guide.
- Euler SSH timeout: connect to ETH VPN and check Euler status.
- Euler password works but SSH key does not: follow Euler SSH troubleshooting.
UNPROTECTED PRIVATE KEY FILE: inspect which file is named; a.pubfilename usually meansIdentityFileis wrong.- Tunnel asks for ETH password: make the public-key-only
key-oktest pass before troubleshooting VS Code.
Git And Code#
- Wrong files staged:
git restore --staged <path>keeps the edit but removes it from the staged diff. - Secret committed: revoke it immediately and notify the repository owner.
- Push rejected: fetch and inspect remote changes; do not force-push a shared branch without explicit coordination.
- Python works only in one old environment: recreate from declared dependencies and record what is missing.
AI Coding Agents#
- Copilot Student asks for payment or is unavailable: verify the GitHub Education account and continue manually; payment is not required.
- Zed keeps using an old OpenRouter key: inspect local
OPENROUTER_API_KEYprecedence before replacing keychain settings. - Agent changes too much, forgets constraints, reports unproven tests, or spends unexpectedly: stop the session and use the AI agent troubleshooting guide.
Euler Jobs#
- Job pending: inspect
myjobs -j <job-id>and thesqueuereason; do not submit duplicates. - Job fails immediately: inspect logs and
sacctstate/exit code. - Out of memory: inspect application behavior and
MaxRSSbefore changing memory. - GPU allocated but idle: inspect device placement, CPU/data loading, and I/O before adding GPUs.
- Array starts too much work: cancel the parent job and add a low
%cap. - ParaView GUI does not connect: use matching local ParaView 6.0.0, download
a fresh ETH
euler_600.pvsc, and follow the ParaView recovery steps.
See the full Euler troubleshooting guide.
Storage And Permissions#
- NAS path not found: confirm VPN, supervisor first name, and exact assigned folder.
- Euler quota failure: run
lquotaand inspect both capacity and file count. - Shared folder not writable: inspect
ls -ld,getfacl, andid; ask the data owner to repair the specific folder. - Important file was in scratch/Blade
D:only: report possible data loss and restore from an authoritative copy.
Ask For Help Safely#
Use this template:
Operating system:
Machine and shell where command ran:
Guide and section followed:
Sanitized command:
Exact error:
Expected result:
Checks attempted:
Replace secrets and confidential values with <redacted>. Never attach an SSH
private key, password, token, recovery code, .env, or protected dataset.