feat: add DEFAULT_WORKSPACE_SLUGS instance config for auto-onboarding

[Quentin-M]

Problem

Self-hosted single-organization deployments have no way to automatically add new users to existing workspaces. Every new user hits the onboarding flow and is asked to create a workspace — even when workspace creation is disabled. The only workaround is manually inviting every user before they log in.

Solution

Add a new instance configuration key DEFAULT_WORKSPACE_SLUGS. When set, new users with no workspace memberships are automatically added as Members to the configured workspaces on first login, and marked as onboarded, so they land directly in the workspace.

Behavior

• Comma-separated slugs: "my-org,my-org-dev" — joins specific workspaces; first slug is the landing workspace
• Wildcard *: auto-joins all workspaces on the instance; oldest workspace is the landing workspace
• Safe for existing users: only fires when the user has zero workspace memberships
• Skips onboarding: sets is_onboarded=True and all onboarding_step flags so the user goes straight to the workspace
• Configurable via God Mode: text input under Workspace Management settings
• Env var fallback: DEFAULT_WORKSPACE_SLUGS env var, same as all other instance config

Changes

File	Change
apps/api/plane/utils/instance_config_variables/core.py	Register DEFAULT_WORKSPACE_SLUGS in workspace_management_config_variables
apps/api/plane/authentication/utils/workspace_project_join.py	Add auto_join_default_workspaces(user)
apps/api/plane/authentication/utils/user_auth_workflow.py	Call auto_join_default_workspaces after invite processing
packages/types/src/instance/workspace.ts	Add "DEFAULT_WORKSPACE_SLUGS" to TInstanceWorkspaceConfigurationKeys
apps/admin/app/(all)/(dashboard)/workspace/page.tsx	God Mode UI: text input with */slug hint

Testing

1. Set DEFAULT_WORKSPACE_SLUGS=my-workspace in God Mode or env
2. New user logs in → lands directly in my-workspace, no onboarding
3. Existing user with memberships logs in → unaffected
4. Set DEFAULT_WORKSPACE_SLUGS=* → new user joins all workspaces
5. Unset → standard onboarding flow restored

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 6e34a11e-4f1b-43e1-9343-0fcbebe84f79

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

📝 Coding Plan

• Generate coding plan for human review comments

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

Tip

You can validate your CodeRabbit configuration file in your editor.

If your editor has YAML language server, you can enable auto-completion and validation by adding # yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json at the top of your CodeRabbit configuration file.