Skip to content

Admin MultiProject Failfix

github-actions[bot] edited this page Apr 14, 2026 · 1 revision

Admin Multi-Project Fail-Fix Playbook

Common issues with the admin multi-project switcher and their fixes.

Dropdown empty

Cause: ~/.config/nself/admin/projects.json is missing or malformed.

Fix:

  1. Check if the file exists: cat ~/.config/nself/admin/projects.json
  2. If missing, re-register projects:
    nself admin projects add --name nself --host nself-prod --ssh-user ops
    nself admin projects add --name unity --host unity-prod
    nself admin projects add --name ummat --host ummat-prod
    nself admin projects add --name camarata --host nclaw-prod --ssh-user ops
  3. If malformed, delete and re-register: rm ~/.config/nself/admin/projects.json

ACL bypass possible

Cause: Middleware ordering. The ACL check must run before the project loader.

Fix: Verify middleware order in admin server:

auth -> ACL check -> project loader -> audit -> handler

If the project loader runs before ACL, it loads project context for unauthorized users. The ACL middleware must return 403 project_not_authorized before any project data is touched.

Switch leaves stale data

Cause: Client-side store not cleared on project switch.

Fix: The admin UI must dispatch a reset() action on the client-side store when the project selector changes. Every store slice (env vars, plugins, metrics) must be cleared before loading new project data.

Verify: switch between two projects with different plugin lists. If the old project's plugins flash briefly, the store is not being reset.

Home


Getting Started


Commands


Features


Configuration


Plugins (87 + 10 monitoring)

Free (25)
Pro (62)
Planned (26)
  • plugin-audit
  • plugin-blog
  • plugin-checkout
  • plugin-commerce
  • plugin-drm
  • plugin-export
  • plugin-flow
  • plugin-import
  • plugin-ldap
  • plugin-mailgun
  • plugin-media
  • plugin-oauth-providers
  • plugin-pages
  • plugin-postmark
  • plugin-rate-limit
  • plugin-reports
  • plugin-saml
  • plugin-scheduler
  • plugin-sendgrid
  • plugin-sso
  • plugin-subscription
  • plugin-thumb
  • plugin-transcoder
  • plugin-twilio
  • plugin-waf
  • plugin-watermark

Guides


Architecture


Reference


Licensing


Security


Brand


Operations


Contributing


Admin


Changelog

Clone this wiki locally