Skip to content

2.3.69 Satellite Perplexideez

av edited this page Apr 16, 2026 · 2 revisions

Handle: perplexideez URL: http://localhost:34261/

Perplexideez is a self-hosted perplexity-style AI search application. It supports multiple LLM backends and integrates with SearXNG for web search.

Starting

# [Optional] Pull the perplexideez images
# ahead of starting the service
harbor pull perplexideez

# Start the service — works best with searxng and ollama
harbor up perplexideez searxng ollama

# [Optional] Open the service in browser
harbor open perplexideez

Configuration

Harbor pre-connects Perplexideez to ollama and searxng when running together via cross-service compose files.

Variable Default Description
HARBOR_PERPLEXIDEEZ_HOST_PORT 34261 Host port for the Perplexideez UI
HARBOR_PERPLEXIDEEZ_IMAGE ghcr.io/brunostjohn/perplexideez/app Docker image
HARBOR_PERPLEXIDEEZ_VERSION latest Image version/tag
HARBOR_PERPLEXIDEEZ_MIGRATE_IMAGE ghcr.io/brunostjohn/perplexideez/migrate:latest Database migration image

Additional configuration is done via services/perplexideez/override.env. Notable options:

# The public-facing base URL must match the URL you use to access the service
PUBLIC_BASE_URL="http://localhost:34261"

# Change the auth and rate-limit secrets before production use
AUTH_SECRET="sk-harbor-perplexideez"
RATE_LIMIT_SECRET="sk-harbor-perplexideez-rate-limit"

# LLM models (when using Ollama)
LLM_SPEED_MODEL="gemma2:2b"
LLM_BALANCED_MODEL="llama3.1:latest"
LLM_QUALITY_MODEL="qwen2.5:32b"
LLM_EMBEDDINGS_MODEL="nomic-embed-text:latest"

# User registration
DISABLE_SIGN_UP="false"

To use an OpenAI-compatible backend instead of Ollama, set in services/perplexideez/override.env:

LLM_MODE="openai"
OPENAI_BASE_URL="<your-api-base-url>"
OPENAI_API_KEY="<your-api-key>"

Related Services

  • SearXNG — web search backend used by Perplexideez
  • Perplexica — similar AI-powered search service
  • Ollama — default LLM backend

Clone this wiki locally