Skip to main content

​
Ollama Embeddings Configuration

Ollama Embeddings Configuration Interface The Ollama embeddings configuration screen in Novaplan AI where you’ll enter your Model Name and optional Endpoint URL Novaplan AI can use an Ollama embedding service operated by your organization or Novaplan. Coordinate the server, network access, and data handling with Novaplan; an Ollama service outside the managed workspace still receives embedding requests over the network.

​
Required Fields

​
Model Name *

The Model Name field defines which Ollama embedding model you want to use with Novaplan AI. Popular Ollama embedding models include:
  • mxbai-embed-large - A high-performance embedding model well-suited for retrieval tasks
How to choose a model:
  • For general-purpose retrieval, select mxbai-embed-large
  • Check Ollama’s model library for the full list of available embedding models
  • Pull the model first with ollama pull <model-name> before configuring it in Novaplan AI

​
Optional Fields

​
Endpoint URL

The URL where your Ollama instance is running. Defaults to http://host.docker.internal:11434 if left blank. Common configurations:
  • http://host.docker.internal:11434 — application default; use only if Novaplan confirms that the managed workspace can reach Ollama through this hostname
  • https://your-server-domain — for remote Ollama instances
Note: Your computer’s localhost is not automatically reachable from a managed Novaplan AI workspace. Confirm the actual endpoint with Novaplan before configuring it.

​
API Key

Optional. Leave blank for standard local Ollama instances, which do not require authentication. When to use:
  • If you have configured authentication on your Ollama instance
  • When connecting to a secured remote Ollama server

​
Configuration Steps

As shown in the image above:
  1. Click Configure on the Ollama provider card
  2. Enter your Model Name (marked with *) — e.g. mxbai-embed-large
  3. (Optional) Specify your Endpoint URL — defaults to http://host.docker.internal:11434
  4. (Optional) Enter an API Key if your Ollama instance requires authentication
  5. Click Add Model to save and validate your credentials
Model Name is the only required field. No API key is needed for a standard local Ollama installation. The endpoint defaults to http://host.docker.internal:11434 if left blank.

​
Prerequisites

Before configuring Ollama in Novaplan AI, ensure you have:
  1. Ollama installed on your machine or server — download from ollama.com
  2. The embedding model pulled:
  3. Ollama running: ollama serve
  4. Network accessible: Novaplan must confirm the managed workspace can reach the Ollama endpoint

​
Usage Considerations

  • Embedding requests are processed by the Ollama server your organization or Novaplan provides; confirm its location and access controls
  • No API key or usage costs required
  • Processing speed depends on your server’s available CPU/memory/GPU

​
Troubleshooting

  • Verify Ollama is running: ollama list
  • Check the endpoint URL matches where Ollama is accessible
  • Ensure port 11434 is not blocked by a firewall
  • Ask Novaplan to verify the managed workspace can reach the configured endpoint; the default host.docker.internal may not resolve there
  • If the model is not found, pull it first: ollama pull <model-name>
For additional support, refer to the Ollama documentation or contact Novaplan AI support.