Movatterモバイル変換

[0]ホーム
URL:

Skip to main content

Self-Host

Learn about how to self-host Khoj on your own machine.

Benefits to self-hosting:

  1. Privacy: Your data will never have to leave your private network. You can even use Khoj without an internet connection if deployed on your personal computer.
  2. Customization: You can customize Khoj to your liking, from models, to host URL, to feature enablement.

Setup Khoj​

These are the general setup instructions for self-hosted Khoj.You can install the Khoj server using eitherDocker orPip.

Offline Model + GPU

To use the offline chat model with your GPU, we recommend using the Docker setup with Ollama . You can also use the local Khoj setup via the Python package directly.

First Run

Restart your Khoj server after the first run to ensure all settings are applied correctly.

  • Docker
  • Pip
  • MacOS
  • Windows
  • Linux

Prerequisites

Docker

  • Option 1: Click here to installDocker Desktop. Make sure you also install theDocker Compose tool.

  • Option 2: UseHomebrew to install Docker and Docker Compose.

    brew install --cask docker
    brew install docker-compose

Setup

  1. Download the Khoj docker-compose.yml filefrom Github
    mkdir ~/.khoj && cd ~/.khoj
    wget https://raw.githubusercontent.com/khoj-ai/khoj/master/docker-compose.yml
  2. Configure the environment variables in thedocker-compose.yml
    • SetKHOJ_ADMIN_PASSWORD,KHOJ_DJANGO_SECRET_KEY (and optionally theKHOJ_ADMIN_EMAIL) to something secure. This allows you to customize Khoj later via the admin panel.
    • SetOPENAI_API_KEY,ANTHROPIC_API_KEY, orGEMINI_API_KEY to your API key if you want to use OpenAI, Anthropic or Gemini commercial chat models respectively.
    • UncommentOPENAI_BASE_URL to useOllama running on your host machine. Or set it to the URL of your OpenAI compatible API like vLLM orLMStudio.
  3. Start Khoj by running the following command in the same directory as your docker-compose.yml file.
    cd ~/.khoj
    docker-compose up
Remote Access

By default Khoj is only accessible on the machine it is running. To access Khoj from a remote machine seeRemote Access Docs.

Your setup is complete once you see🌖 Khoj is ready to use in the server logs on your terminal.

Use Khoj​

You can now open the web app athttp://localhost:42110 and start interacting!
Nothing else is necessary, but you can customize your setup further by following the steps below.

First Message to Offline Chat Model

The offline chat model gets downloaded when you first send a message to it. The download can take a few minutes! Subsequent messages should be faster.

Add Chat Models​

Login to the Khoj Admin Panel

Go tohttp://localhost:42110/server/admin and login with the admin credentials you setup during installation.

CSRF Error

Ensure you are usinglocalhost, not 127.0.0.1, to access the admin panel to avoid the CSRF error.

CSRF Trusted Origin or Unset Cookie Error

If using a load balancer/reverse_proxy in front of your Khoj server: Set the environment variable KHOJ_ALLOWED_DOMAIN=your-internal-ip-or-domain to avoid this error.If unset, it defaults to KHOJ_DOMAIN.

DISALLOWED HOST or Bad Request (400) Error

You may hit this if you try access Khoj exposed on a custom domain (e.g. 192.168.12.3 or example.com) or over HTTP.Set the environment variables KHOJ_DOMAIN=your-external-ip-or-domain and KHOJ_NO_HTTPS=True if required to avoid this error.

Note

Using Safari on Mac? You might not be able to login to the admin panel. Try using Chrome or Firefox instead.

Configure Chat Model

Setup which chat model you'd want to use. Khoj supports local and online chat models.

  • OpenAI
  • Anthropic
  • Gemini
  • Offline
Ollama Integration

Using Ollama? See theOllama Integration section for more custom setup instructions.

  1. Create a newAI Model Api in the server admin settings.
    • Add yourOpenAI API key
    • Give the configuration a friendly name likeOpenAI
    • (Optional) Set the API base URL. It is only relevant if you're using another OpenAI-compatible proxy server likeOllama orLMStudio.
      example configuration for ai model api
  2. Create a newchat model
    • Set thechat-model field to anOpenAI chat model. Example:gpt-4o.
    • Make sure to set themodel-type field toOpenAI.
    • If your model supports vision, set thevision enabled field totrue. This is currently only supported for OpenAI models with vision capabilities.
    • Thetokenizer andmax-prompt-size fields are optional. Set them only if you're sure of the tokenizer or token limit for the model you're using. Contact us if you're unsure what to do here.
      example configuration for chat model options
Multiple Chat Models

Set your preferred default chat model in theDefault,Advanced fields of yourServerChatSettings.Khoj uses these chat model for all intermediate steps like intent detection, web search etc.

Chat Model Fields
  • Thetokenizer andmax-prompt-size fields are optional. Set them only if you're sure of the tokenizer or token limit for the model you're using. This improves context stuffing. Contact us if you're unsure what to do here.
  • Only tick thevision enabled field for OpenAI models with vision capabilities like gpt-4o. Vision capabilities in other chat models is not currently utilized.

Sync your Knowledge​

  • You can chat with your notes and documents using Khoj.
  • Khoj can keep your files and folders synced using the KhojDesktop,Obsidian orEmacs clients.
  • YourNotion workspace can be directly synced from the web app.
  • You can also just drag and drop specific files you want to chat with on theWeb app.

Setup Khoj Clients​

The Khoj web app is available by default to chat, search and configure Khoj.
You can also install a Khoj client to easily access it from Obsidian, Emacs, Whatsapp or your OS and keep your documents synced with Khoj.

Note

Set the host URL on your clients settings page to your Khoj server URL. By default, usehttp://127.0.0.1:42110 orhttp://localhost:42110. Note thatlocalhost may not work in all cases.

  • Desktop
  • Emacs
  • Obsidian
  • Whatsapp

Upgrade​

Upgrade Server​

  • Pip
  • Docker
pip install --upgrade khoj

Note: To upgrade to the latest pre-release version of the khoj server run below command

Upgrade Clients​

  • Desktop
  • Emacs
  • Obsidian
  • The Desktop app automatically updates to the latest released version on restart.
  • You can manually download the latest version from theKhoj Website.

Uninstall​

Uninstall Server​

  • Pip
  • Docker
# uninstall khoj server
pip uninstall khoj

# delete khoj postgres db
dropdb khoj -U postgres

Uninstall Clients​

  • Desktop
  • Emacs
  • Obsidian

Uninstall the Khoj Desktop client in the standard way from your OS.

Troubleshoot​

Dependency conflict when trying to install Khoj python package with pip​

  • Reason: When conflicting dependency versions are required by Khoj vs other python packages installed on your system
  • Fix: Install Khoj in a python virtual environment usingvenv orpipx to avoid this dependency conflicts
  • Process:
    1. Installpipx
    2. Usepipx to install Khoj to avoid dependency conflicts with other python packages.
      pipx install khoj
    3. Now startkhoj using the standard steps described earlier

Install fails while building Tokenizer dependency​

  • Details:pip install khoj fails while building thetokenizers dependency. Complains about Rust.
  • Fix: Install Rust to build the tokenizers package. For example on Mac run:
    brew install rustup
    rustup-init
    source ~/.cargo/env
  • Refer:Issue with Fix for more details

Khoj in Docker errors out with "Killed" in error message​

[8]ページ先頭
©2009-2025 Movatter.jp