Curriculum previewThis is not your assigned passport. No identity, answers, or completion progress are stored here.How to start your passport
Handbook / help

help

Troubleshooting By Symptom

Choose the symptom, not the technology you think caused it.

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 .pub filename usually means IdentityFile is wrong.
  • Tunnel asks for ETH password: make the public-key-only key-ok test 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_KEY precedence 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 the squeue reason; do not submit duplicates.
  • Job fails immediately: inspect logs and sacct state/exit code.
  • Out of memory: inspect application behavior and MaxRSS before 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 lquota and inspect both capacity and file count.
  • Shared folder not writable: inspect ls -ld, getfacl, and id; 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.