LibrePortal
Sponsor
Install

Vane

AI Search (Perplexica)

Ask a question and get a written answer with its sources, searched through SearXNG and answered by a model on your server

On this page
  1. At a glance
  2. Addresses and ports
  3. Settings
  4. In its config file
  5. Works with
  6. Privacy and security
  7. What leaves this server
  8. What LibrePortal turns off
  9. Sources
  10. Under the hood

Good to know before you install

Vane has no login of its own, so keep it private or turn on Authelia; it needs SearXNG and Ollama to answer.

At a glance#

What it is
AI Search (Perplexica) AI
Where it opens
Web Interface On its own port at http://your-server:port, or vane.your-domain once you have a domain
Updates
When you choose New versions wait for you to press Update
Backups
Included Part of the daily backup when that's switched on
Copies
One per server

There's no step-by-step guide for Vane here yet. Everything below comes straight from the app catalogue, so it's what LibrePortal really does when you install it. For using Vane itself, its own documentation is the place to go: github.com/ItzCrazyKns/Vane.

Addresses and ports#

Vane has one port. LibrePortal picks a free port number for each when you install, so yours will differ from anyone else's. The Config tab's Network section shows them, and the app's Open button uses the right one.

What it isWho can reach itWith a domain
Web Interface Trusted places only vane.your-domain

Settings#

These are Vane's own settings on its Config tab. The settings every app shares, like backups, updates and where its data lives, are explained in App pages and settings.

SettingWhat it doesStarts as
Ollama Model The model fetched into Ollama for answers. Empty fetches none. llama3.2:3b

In its config file#

A few more aren't on the Config tab yet. They live in the app's config file, described here so you know they exist. How to change them.

SettingWhat it doesStarts as
Name
CFG_VANE_DISPLAY_NAME
What this app is called on your dashboards. Leave empty to use its usual name Empty
Show on the LibrePortal Dashboard
CFG_VANE_SHOW_ON_DASHBOARD
Whether this app gets a shortcut on the front page of the LibrePortal WebUI, separate from any Dashy dashboard
Choices: true, false
true

Works with#

These are the other apps Vane knows how to work with. Once it's installed, its page shows the same list with whether each one is connected. How this works.

  • Web search: Searches the web through SearXNG, so your questions are not tied to you. LibrePortal sets this up by itself when both are installed.
  • Answers: Writes its answers with a model running on this server. LibrePortal sets this up by itself when both are installed.
  • Grafana: Shows dashboards for the apps that have one. works with every app
  • Prometheus: Collects metrics from the apps that can export them. works with every app
  • Uptime Kuma: Watches your apps and shows when one goes down. works with every app

Privacy and security#

All clear Vane is an AI search assistant. It uses your own search server and your own AI model, so nothing goes to outside AI companies unless you add them yourself.

What leaves this server#

Nothing leaves this server on its own.

What LibrePortal turns off#

Nothing needed switching off.

Licence: MIT. Audited: 21 October 2026. See the privacy of every app and the Promise.

Sources#

Under the hood#

  • It runs this image: itzcrazykns1337/vane:slim-v1.12.2@sha256:d2878cf9c91962aa3fc053b59bc9b89adcbdcaeb7ee36b54906e853464b2c190. The version is pinned, and moves only when you update it.
  • It can sit behind Authelia's sign-in once Authelia is installed.
  • Its own project and documentation: github.com/ItzCrazyKns/Vane

Ports, settings, tools and connections on this page are read from LibrePortal v0.10.97's app catalogue each time the guide is built.

Next steps