Skip to main content
Looking to install Open WebUI?

This page covers Docker installation only. For Open WebUI installation instructions via Docker, please visit our Quick Start Guide which provides comprehensive setup instructions.

warning

This tutorial is a community contribution and is not supported by the Open WebUI team. It serves only as a demonstration on how to customize Open WebUI for your specific use case. Want to contribute? Check out the contributing tutorial.

Installing Docker

For Windows and Mac Users​

  • Download Docker Desktop from Docker's official website.
  • Follow the installation instructions on the website.
  • After installation, open Docker Desktop to ensure it's running properly.

For Ubuntu Users​

  1. Open your terminal.

  2. Set up Docker's apt repository:

    sudo apt-get update
    sudo apt-get install ca-certificates curl
    sudo install -m 0755 -d /etc/apt/keyrings
    sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
    sudo chmod a+r /etc/apt/keyrings/docker.asc
    echo \
      "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
      $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
      sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
note

If using an Ubuntu derivative (e.g., Linux Mint), use UBUNTU_CODENAME instead of VERSION_CODENAME.

  1. Install Docker Engine:

    sudo apt-get update
    sudo apt-get install docker-ce docker-ce-cli containerd.io docker-compose-plugin

  2. Verify Docker Installation:

    sudo docker run hello-world

For Other Linux Distributions​

For other Linux distributions, refer to the official Docker documentation.

Install and Verify Ollama​

  1. Download Ollama from https://ollama.com/.

  2. Verify Ollama Installation: