What this error means

Error: connection refused at localhost:11434 OR dial tcp [::1]:11434: connect: connection refused is a Ollama failure pattern reported for developers trying to developer tries to run ollama locally but gets connection refused errors — service isn't running, port conflict, or firewall blocking local connections — preventing local llm inference. Based on the imported evidence, treat this as a tool-specific troubleshooting page rather than a generic API error.

Why this happens

P1 priority technology. Ollama has explosive growth in local LLM adoption. Connection refused on port 11434 is the most fundamental Ollama error, occurring when daemon crashes, fails to start, or network config blocks access. Commercial value stems from Ollama Pro offering and enterprise self-hosted deployments. Search strategy from sources-guide.md targets 'ollama connection refused'. Not yet in covered-errors.md. High search demand given massive wave of developers setting up local AI assistants. Additional common variant: 'pulling manifest error' for model download failures.

Common causes

  • P1 priority technology. Ollama has explosive growth in local LLM adoption. Connection refused on port 11434 is the most fundamental Ollama error, occurring when daemon crashes, fails to start, or network config blocks access. Commercial value stems from Ollama Pro offering and enterprise self-hosted deployments. Search strategy from sources-guide.md targets 'ollama connection refused'. Not yet in covered-errors.md. High search demand given massive wave of developers setting up local AI assistants. Additional common variant: 'pulling manifest error' for model download failures.

Quick fixes

  1. Confirm the exact error signature matches Error: connection refused at localhost:11434 OR dial tcp [::1]:11434: connect: connection refused.
  2. Check the Ollama account, local tool state, and provider configuration involved in the failing workflow.
  3. Confirm the local service is running on the expected host and port, then retry the smallest request.

Platform/tool-specific checks

  • Verify the command, editor, extension, or API client that produced the error.
  • Compare local settings with CI, deployment, or editor-level settings when the error appears in only one environment.
  • Avoid deleting credentials, local model data, or project settings until the failing scope is clear.

Step-by-step troubleshooting

  1. Capture the exact error message and the command, editor action, or request that triggered it.
  2. Check whether the failure is account/auth, quota/rate, model/provider, local runtime, or deployment configuration.
  3. Review the source evidence below and compare it with your environment.
  4. Apply one change at a time and rerun the smallest failing action.
  5. Keep the working fix documented for the team or deployment environment.

How to prevent it

  • Keep provider/tool configuration documented.
  • Record non-secret diagnostics such as tool version, provider name, model name, and command path.
  • Add a lightweight check before CI or production workflows depend on the tool.