Software troubleshooting desk

Practical fixes for tool errors, setup blocks, and workflow issues.

Symptom

Cause

Fix route

Verify

Fresh repair notes

All notes

Fix Docker Compose Port Allocation Errors

When you run docker compose up and see an error like "port is already alloca...

How to Fix the Git index.lock File Exists Error
You're in the middle of a Git operation—commit, merge, or rebase—and Git stops with: fa...

Fix Nginx Upstream Connection Refused in Proxy Pass When Nginx returns a 502 Bad Gateway or logs upstream connection refused

Fix Cloudflare Wildcard Subdomain DNS Propagation Delay You set up a wildcard DNS record (e.g., *.example.com) in Cloudflare, but new subdom...

Fix 'pip externally managed environment' Permission Denied Error If you see error: externally-managed-environment when trying to install a Python pac...

Fix 'pip externally managed environment' Error for venv Setup When creating a Python virtual environment on newer Linux distributions (e.g., Debian 12, Ubuntu ...

Issue queue Sitemap Fix pip Permission Denied Error: Step-by-Step Fix Node Sass Build Failure by Upgrading Node Version Cloudflare 522 Error After Server Migration: Fixes That Work How to Debug Docker Compose Environment Variables How to Use a Cloudflare DNS Propagation Checker Tool Git Pull Refusing to Merge Unrelated Histories Fix Resolving Git SSL Certificate Error with Proxy Troubleshoot Windows Security App Launch Issues Enable Wildcard Subdomain in Cloudflare: Step-by-Step Windows Shared Folder Access Error: Advanced Sharing Settings Fix Fix Remote Desktop Connection Failed Due to Locked User Account Nginx Upstream Socket Permission Denied Guide Desk note Troubleshooting paths Home Windows FixesmacOS HelpBrowser IssuesOffice ToolsDeveloper ToolsCloud SoftwareSecurity ToolsBackup RecoveryNetwork ToolsDatabase ToolsAI ToolsProductivity AppsCLI ErrorsDocker KubernetesEmail ClientsFile Utilities