Troubleshoot QCDS Installation, Menu Access, or Workspace Provisioning

When a user cannot open the QCDS frontend, separate the problem into three layers: the installed package/plugin, the Joomla frontend menu/access gate, and workspace provisioning. QCDS resolves first-access provisioning synchronously, so a correctly authorized user should not have to wait for a Scheduled Task before opening a workspace.

1. Confirm the Current Package and Task Plugin

Open Joomla Administrator → QC Digital Signature → Status and confirm the installed version. If the QCDS task plugin is missing or its files are incomplete, reinstall the current full QCDS package rather than creating substitute task rows by hand.

If only automation is broken but the component opens, continue with the Scheduled Tasks troubleshooting guide instead of treating it as a workspace problem.

2. Check the Frontend Menu Gate

The authenticated QCDS workspace application requires at least one published Joomla site menu item whose link targets index.php?option=com_qcdigitalsignature.... The signed-in user must also be authorized for that menu item's Joomla access level.

If no accessible published QCDS menu item exists, the frontend application returns Signing application unavailable. This gate hides the account application; it does not invalidate secure signer invitations that were already sent.

3. Confirm the User Is Signed In

The sender/workspace frontend requires an authenticated Joomla user. A logged-out visitor receives the login-required state. After signing in, open QCDS through the published menu item rather than testing an old copied component URL.

4. Private / Organization Mode

Private / Organization Mode uses one primary shared organization workspace. The owner, platform managers, users in an active mapped Joomla group, and users already assigned a workspace role can qualify for access.

When no active group mappings exist, QCDS can also use the published menu item's access level for first-access auto-join (the default behavior) and add that authorized Joomla user to the shared workspace as a sender. Once any active group mapping exists, mappings become authoritative and that menu-based fallback stops.

5. White-Label SaaS Mode

SaaS Mode provisions customer workspaces from active Joomla user-group-to-plan mappings. If no active mappings exist, QCDS reports Account setup could not be completed and directs the administrator to configure Plans & Entitlements.

If the user has no qualifying mapped group, the account is unqualified. Losing the qualifying group can start the configured provisioning grace period and later suspend the workspace; historical workspace records remain preserved. Restoring a qualifying mapping allows reconciliation to restore the workspace.

6. Use the Visible Reference When Provisioning Fails

If first-access provisioning throws an unexpected error, QCDS returns a controlled message with a generated reference. Record that reference, the Joomla user, QCDS version, operating mode, and visible status. Do not delete the workspace or reinstall blindly; a missing linked workspace or provisioning configuration problem should be repaired while preserving historical records.

Community Discussion

Want to compare workflows, share practical tips, or discuss how you use this QCDS feature? Visit the QC Digital Signature Community. For private support, bug reports, account-specific issues, or feature requests, use the QuantaCade support system.