← Directory

khoj-aio

Khoj is a self-hosted AI second brain for chatting with your docs, the web, and local or hosted LLMs.

  • AI
  • Productivity
  • Tools & Utilities
Khoj is a self-hosted AI second brain for chatting with your docs, the web, and local or hosted LLMs. All-In-One Unraid Edition `khoj-aio` packages the Khoj server with an internally managed PostgreSQL database so beginners can get a clean first boot on Unraid without wiring a separate database container. Quick Install (Beginners) 1. Install the template and leave the default appdata paths in place. 2. Optionally set [code]KHOJ_ADMIN_EMAIL[/code], [code]KHOJ_ADMIN_PASSWORD[/code], and [code]KHOJ_DJANGO_SECRET_KEY[/code]. 3. Leave [code]KHOJ_ANONYMOUS_MODE=true[/code] for the simplest private LAN-first install, then click Apply. 4. Wait for first boot to finish, open [code]http://SERVER_IP:42110[/code], and restart the container once after the initial setup so all settings are applied cleanly. 5. If you left the password or secret blank, the container generates secure

Platform availability

Available on 1 of 9 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

48/100 Fair

Maintained
80last commit 119 days ago
Popular
144 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
404 GB minimum RAM, runs on ARM

Availability: platform listings confirmed today, links checked 16 days ago

GitHub stars
4
Open issues
1
Last commit
2026-06-18
Latest release
2.0.0-beta.28-aio.7
Activity
stale

Checked 8 days ago - source: GitHub (JSONbored/khoj-aio)

Resources & Compatibility

Minimum requirements: 4 GB RAM, 2 CPU core(s). ARM (e.g. Raspberry Pi) is supported.

Checked 17 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Start Khoj with Docker first Make a ~/.khoj folder, download the official docker-compose.yml (the file Docker uses to start Khoj) into it, and run docker-compose up there. Keep that folder and wait for the log to say '🌖 Khoj is ready to engage' before testing clients, or you may think the install failed. source
  • Set up the Emacs client correctly If you use Emacs, put the API key (a secret token), server URL, and the exact folders/files you want searched into the config. Without the API key or server URL, Emacs can't reach Khoj, and without the path list it won't index the notes you expect. source
  • Use Mistral with LiteLLM only if ready If you want Mistral Tiny (a small language model) through LiteLLM, install it, set MISTRAL_API_KEY to your real key, then start the proxy. Starting it without that key will leave the AI connection broken or unavailable. source

Fetched 17 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

Do I need to run a separate PostgreSQL container for khoj-aio on Unraid?

No, the AIO image bundles PostgreSQL with pgvector and defaults to the internal database. You can still move PostgreSQL out using the standard POSTGRES_* settings.

Which port does khoj-aio use for the web UI and API?

It serves the Khoj web UI and API on port 42110.

What persistent data is stored in the khoj-aio appdata path?

The mapped appdata path stores config, database state, and model caches.

Should I restart khoj-aio after the first boot?

Yes, restart the container once after initial setup so all settings are fully applied.

What must I check before exposing khoj-aio beyond my local network?

Remote exposure still needs correct auth and domain settings, so the default private LAN-first setup should not be published without review.

Which Khoj release line does khoj-aio track?

It tracks the latest published production-facing release line rather than floating latest, even though upstream Khoj releases are currently tagged beta.

Answers sourced from github.com

Community

Collected 16 days ago - public community threads