---
title: Using Ollama in LobeChat
description: >-
  Learn how to use Ollama in LobeChat, run LLM locally, and experience
  cutting-edge AI usage.
tags:
  - Ollama
  - Local LLM
  - Ollama WebUI
  - Web UI
  - API Key
---

# Using Ollama in LobeChat

<Image
  alt={'Using Ollama in LobeChat'}
  borderless
  cover
  src={'https://github.com/lobehub/lobe-chat/assets/17870709/f579b39b-e771-402c-a1d1-620e57a10c75'}
/>

Ollama is a powerful framework for running large language models (LLMs) locally, supporting various language models including Llama 2, Mistral, and more. Now, LobeChat supports integration with Ollama, meaning you can easily enhance your application by using the language models provided by Ollama in LobeChat.

This document will guide you on how to use Ollama in LobeChat:

<Video
  alt="demonstration of using Ollama in LobeChat"
  height={580}
  src="https://github.com/lobehub/lobe-chat/assets/28616219/c32b56db-c6a1-4876-9bc3-acbd37ec0c0c"
/>

## Using Ollama on macOS

<Steps>

### Local Installation of Ollama

[Download Ollama for macOS](https://ollama.com/download?utm_source=lobehub&utm_medium=docs&utm_campaign=download-macos) and unzip/install it.

### Configure Ollama for Cross-Origin Access

Due to Ollama's default configuration, which restricts access to local only, additional environment variable setting `OLLAMA_ORIGINS` is required for cross-origin access and port listening. Use `launchctl` to set the environment variable:

```bash
launchctl setenv OLLAMA_ORIGINS "*"
```

After setting up, restart the Ollama application.

### Conversing with Local Large Models in LobeChat

Now, you can start conversing with the local LLM in LobeChat.

<Image
  alt="Chat with llama3 in LobeChat"
  height="573"
  src="https://github.com/lobehub/lobe-chat/assets/28616219/7f9a9a9f-fd91-4f59-aac9-3f26c6d49a1e"
/>

</Steps>

## Using Ollama on Windows

<Steps>

### Local Installation of Ollama

[Download Ollama for Windows](https://ollama.com/download?utm_source=lobehub&utm_medium=docs&utm_campaign=download-windows) and install it.

### Configure Ollama for Cross-Origin Access

Since Ollama's default configuration allows local access only, additional environment variable setting `OLLAMA_ORIGINS` is needed for cross-origin access and port listening.

On Windows, Ollama inherits your user and system environment variables.

1. First, exit the Ollama program by clicking on it in the Windows taskbar.
2. Edit system environment variables from the Control Panel.
3. Edit or create the Ollama environment variable `OLLAMA_ORIGINS` for your user account, setting the value to `*`.
4. Click `OK/Apply` to save and restart the system.
5. Run `Ollama` again.

### Conversing with Local Large Models in LobeChat

Now, you can start conversing with the local LLM in LobeChat.

</Steps>

## Using Ollama on Linux

<Steps>

### Local Installation of Ollama

Install using the following command:

```bash
curl -fsSL https://ollama.com/install.sh | sh
```

Alternatively, you can refer to the [Linux manual installation guide](https://github.com/ollama/ollama/blob/main/docs/linux.md).

### Configure Ollama for Cross-Origin Access

Due to Ollama's default configuration, which allows local access only, additional environment variable setting `OLLAMA_ORIGINS` is required for cross-origin access and port listening. If Ollama runs as a systemd service, use `systemctl` to set the environment variable:

1. Edit the systemd service by calling `sudo systemctl edit ollama.service`:

```bash
sudo systemctl edit ollama.service
```

2. Add `Environment` under `[Service]` for each environment variable:

```bash
[Service]
Environment="OLLAMA_HOST=0.0.0.0"
Environment="OLLAMA_ORIGINS=*"
```

3. Save and exit.
4. Reload `systemd` and restart Ollama:

```bash
sudo systemctl daemon-reload
sudo systemctl restart ollama
```

### Conversing with Local Large Models in LobeChat

Now, you can start conversing with the local LLM in LobeChat.

</Steps>

## Deploying Ollama using Docker

<Steps>

### Pulling Ollama Image

If you prefer using Docker, Ollama provides an official Docker image that you can pull using the following command:

```bash
docker pull ollama/ollama
```

### Configure Ollama for Cross-Origin Access

Since Ollama's default configuration allows local access only, additional environment variable setting `OLLAMA_ORIGINS` is needed for cross-origin access and port listening.

If Ollama runs as a Docker container, you can add the environment variable to the `docker run` command.

```bash
docker run -d --gpus=all -v ollama:/root/.ollama -e OLLAMA_ORIGINS="*" -p 11434:11434 --name ollama ollama/ollama
```

### Conversing with Local Large Models in LobeChat

Now, you can start conversing with the local LLM in LobeChat.

</Steps>

## Installing Ollama Models

Ollama supports various models, which you can view in the [Ollama Library](https://ollama.com/library) and choose the appropriate model based on your needs.

### Installation in LobeChat

In LobeChat, we have enabled some common large language models by default, such as llama3, Gemma, Mistral, etc. When you select a model for conversation, we will prompt you to download that model.

<Image
  alt="LobeChat guide your to install Ollama model"
  height="460"
  src="https://github.com/lobehub/lobe-chat/assets/28616219/4e81decc-776c-43b8-9a54-dfb43e9f601a"
/>

Once downloaded, you can start conversing.

### Pulling Models to Local with Ollama

Alternatively, you can install models by executing the following command in the terminal, using llama3 as an example:

```bash
ollama pull llama3
```

<Video
  height="524"
  src="https://github.com/lobehub/lobe-chat/assets/28616219/95828c11-0ae5-4dfa-84ed-854124e927a6"
/>

## Custom Configuration

You can find Ollama's configuration options in `Settings` -> `Language Models`, where you can configure Ollama's proxy, model names, etc.

<Image
  alt={'Ollama Provider Settings'}
  height={274}
  src={'https://github.com/lobehub/lobe-chat/assets/28616219/54b3696b-5b13-4761-8c1b-1e664867b2dd'}
/>

<Callout type={'info'}>
  Visit [Integrating with Ollama](/docs/self-hosting/examples/ollama) to learn how to deploy
  LobeChat to meet integration needs with Ollama.
</Callout>
