Skip to content

Codendum 0.2.0

Latest

Choose a tag to compare

@stefanoferi stefanoferi released this 28 Oct 17:23
· 3 commits to main since this release

Added

  • Web panel, as a preview (web/, documented in docs/web.md): its
    options, routes and pages may still change in a minor release.
    • People register with their e-mail address and wait for approval, unless
      their domain is approved automatically. The first administrator is
      created with a one-time link printed in the panel log.
    • Each approved person gets a personal page with a three-step OpenCode
      guide, the API key and a one-time setup command for macOS, Linux and
      Windows, pinned to the proxy's public key. The Windows script has not
      been tested on a real Windows workstation yet.
    • Administrators approve, block, delete and promote people, renew keys and
      reset passwords; close registration, limit it to e-mail domains and show
      a notice; follow vLLM, the GPU and the users on a live dashboard.
    • Optional single login for Open WebUI through nginx auth_request, with
      the panel's administrators as chat administrators, and a switch for web
      search in the chat.
    • CSRF tokens on every form, rate-limited logins, password change from the
      profile menu.
    • Keys go to a separate api-keys-web.map, so keys from
      scripts/gen-api-keys.sh keep working. The panel mounts the Docker socket
      to reload the proxy and read the vLLM container; this is the main point to
      revisit before it leaves the preview.
    • CODENDUM_WEB_* variables configure it; see docs/web.md.
  • web/patch-nginx.py adapts an existing proxy configuration for the panel.
  • tests/test-web.sh tests the panel end to end in Docker, with
    tests/mock_openwebui.py, in CI and in tests/run.sh; tests/mock_vllm.py
    also exposes the latency histograms the dashboard reads.

Changed

  • config/nginx.example.conf: plain HTTP sent to the TLS port is redirected to
    HTTPS (301) instead of getting nginx's 400 error page.

Fixed

  • scripts/start-proxy.sh --reload reloads nginx with nginx -s reload inside
    the container instead of docker kill --signal HUP. Docker counted the kill
    as a manual stop, so with --restart unless-stopped the proxy did not start
    again after a reboot.

Website: https://codendum.ai