Perplexica is configured via the web setup interface at http://localhost:3000. Most settings including AI provider API keys are managed through the UI rather than environment variables.
| Variable | Description | Required |
|---|---|---|
SEARXNG_API_URL |
URL for external SearxNG instance | Only for :slim-latest Docker version |
If you prefer to run SearxNG separately (using the slim Docker image):
docker run -d -p 3000:3000 \
-e SEARXNG_API_URL=http://your-searxng-url:8080 \
-v perplexica-data:/home/perplexica/data \
--name perplexica \
itzcrazykns1337/perplexica:slim-latest
When using external SearxNG, ensure these settings are enabled:
Configure API keys and models via the setup screen at http://localhost:3000:
For Docker deployments accessing local Ollama:
# Expose Ollama to network
sudo systemctl edit ollama.service
Add:
[Service]
Environment="OLLAMA_HOST=0.0.0.0:11434"
Then restart:
sudo systemctl daemon-reload
sudo systemctl restart ollama
| OS | Ollama URL in Perplexica |
|---|---|
| Windows | http://host.docker.internal:11434 |
| Mac | http://host.docker.internal:11434 |
| Linux | http://<host-ip>:11434 |
Docker volume stores:
Volume path: /home/perplexica/data
Back up the Docker volume for data persistence:
# Backup
docker run --rm -v perplexica-data:/data -v $(pwd):/backup alpine tar czf /backup/perplexica-backup.tar.gz -C /data .
# Restore
docker run --rm -v perplexica-data:/data -v $(pwd):/backup alpine tar xzf /backup/perplexica-backup.tar.gz -C /data
/home/perplexica/data volumeAny questions?
Feel free to contact us. Find all contact information on our contact page.