custom styling for searXNG
  • CSS 89.3%
  • Shell 7.5%
  • HTML 2.2%
  • Vim Snippet 1%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-10-28 10:19:08 +01:00
custom soooxng 2026-10-28 10:19:08 +01:00
deploy.sh soooxng 2026-10-28 10:19:08 +01:00
README.md soooxng 2026-10-28 10:19:08 +01:00
settings.yml.snippet soooxng 2026-10-28 10:19:08 +01:00

soooxng searxng theme

SoooXNG (searxng.sooox.cc) reskinned to match my portfolio sooox.cc

Built for SearXNG 2026.8.16+b2da6b90f (source install, simple theme). Uses SearXNG's supported ui.templates_path setting only; the SearXNG source tree and static/ stay stock.

Layout

custom/
├── soooxng.css                 # theme override, inlined into <head> by deploy.sh
├── index.html                  # front page: text wordmark instead of the SearXNG logo
├── page_with_header.html       # about/preferences/stats header: text wordmark
└── soooxng.svg                 # SoooXNG icon: favicon (data URI) + results-page logo next to the search bar
deploy.sh                       # rebuilds /etc/searxng/templates and restarts searxng
settings.yml.snippet            # ui: keys to merge into settings.yml (not a full settings.yml)

deploy.sh copies the stock templates from /usr/local/searxng/searxng-src/searx/templates to /etc/searxng/templates, drops the custom/ files on top, and patches base.html to inline the CSS and favicon.

Deploy

From the parent directory of this repo:

tar czf - soooxng/custom soooxng/deploy.sh | ssh root@server-ip '
  cat > /tmp/soooxng.tgz && pct push 113 /tmp/soooxng.tgz /root/soooxng.tgz && rm /tmp/soooxng.tgz &&
  pct exec 113 -- sh -c "cd /root && rm -rf soooxng && tar xzf soooxng.tgz && rm soooxng.tgz && /root/soooxng/deploy.sh"'

First time only, merge settings.yml.snippet's ui: keys into /etc/searxng/settings.yml by hand.

Re-run deploy.sh after every SearXNG update, so the copied stock templates match the new code. The restart briefly takes the site down: newt marks the target unhealthy for ~30 s.

soooxng.css is loaded as a Jinja template ({% include %}), so it must never contain a brace followed by %, # or another brace.