Troubleshooting

Solutions for common issues when creating accounts, onboarding, and managing your Orkestia account.

Account Creation Issues

Email Verification Not Received

You signed up but didn't receive the verification email.

Possible causes:

• Email went to spam folder
• Email address has a typo
• Email provider is blocking the message

Solutions:

1. Check spam folder - Look in your spam/junk folder
2. Wait a few minutes - Emails can take 2-5 minutes to arrive
3. Check email address - Verify you entered the correct email
4. Request new verification - Try signing in again to trigger a new email

Verification Link Expired

The verification link in your email has expired.

Solution:

1. Try signing in with your email and password
2. If you haven't verified, you'll be prompted to resend verification
3. Check your email for a new verification link
4. Click the new link promptly

Can't Create Account

You're unable to complete account creation.

Solutions:

1. Check browser - Use a modern browser (Chrome, Firefox, Safari, Edge)
2. Clear cache - Clear browser cache and cookies
3. Try incognito mode - Test in a private/incognito window
4. Check password requirements - Ensure your password meets requirements:
   • Minimum length (typically 8+ characters)
   • Mix of letters, numbers, and special characters

Social Sign-Up Not Working

You can't sign up using Google, GitHub, or another social provider.

Solutions:

1. Check popup blockers - Disable popup blockers for Orkestia
2. Allow redirects - Ensure your browser allows redirects
3. Try email/password - Use email/password sign-up as an alternative
4. Clear cookies - Clear cookies for the social provider

Onboarding Issues

Can't Create Organization

You're unable to create an organization during onboarding.

Possible causes:

• Organization name is too short
• You already have an organization
• Network or server issues

Solutions:

1. Check organization name - Must be at least 1 character
2. Check for existing org - You may already have an organization
3. Refresh the page - Try refreshing and filling the form again
4. Check network - Ensure stable internet connection

Organization Creation Failed

Error: "Organization already exists"

• You already have an organization
• Refresh the page or navigate to dashboard

Error: "Failed to create organization"

• Check your internet connection
• Try again in a few moments
• Contact support if the issue persists

Stuck on Onboarding Page

You're redirected to onboarding but can't proceed.

Solutions:

1. Check form fields - Ensure organization name is filled
2. Try refreshing - Refresh the page and try again
3. Check dashboard - Navigate to / to see if you already have an org
4. Clear browser data - Clear cache and cookies

Invitation Issues

Invitation Link Doesn't Work

The invitation link you received doesn't work or shows an error.

Possible causes:

• Link has expired
• Invitation was cancelled
• Link was copied incorrectly
• Invitation was already accepted

Solutions:

1. Check expiration - Invitations expire after a set time
2. Request new invitation - Ask the organization admin to send a new invitation
3. Verify link - Ensure the entire link was copied (no truncation)
4. Check if accepted - You may have already accepted the invitation

Email Mismatch

You're logged in but your email doesn't match the invitation.

Option 1: Switch Account

1. Click Switch to invitation email
2. Sign out
3. Sign in with the email that matches the invitation
4. Accept the invitation

Option 2: Request New Invitation

1. Continue to dashboard with your current account
2. Ask the organization admin to send a new invitation to your current email

Invitation Already Accepted

Problem: Invitation shows as already accepted

Solutions:

1. Check organizations - Look in your organization list
2. Try dashboard - Navigate to dashboard to see if you're in the org
3. Contact admin - Ask the organization admin to verify your membership

Authentication Issues

Can't Sign In

You're unable to sign in to your account.

Solutions:

1. Check credentials - Verify email and password are correct
2. Reset password - Use "Forgot password" if needed
3. Check email verification - Ensure your email is verified
4. Clear browser data - Clear cache and cookies
5. Try different browser - Test in another browser

Session Expired

You're logged out unexpectedly or see "Session expired" messages.

Solutions:

1. Sign in again - Simply sign in again to restore your session
2. Check browser settings - Ensure cookies are enabled
3. Check time settings - Ensure your device's clock is correct

Redirect Loop

You're stuck in a redirect loop between pages.

Possible causes:

• Authentication state mismatch
• Browser cache problems

Solutions:

1. Clear browser cache - Clear all cache and cookies
2. Sign out and sign in - Sign out completely, then sign in again
3. Try incognito mode - Test in a private window

Callback Page Errors

You see errors on the /auth/callback page.

Error: "No authorization code received"

• The OAuth flow was interrupted
• Try signing in again from the beginning
• Ensure popup blockers are disabled

Error: "Authentication failed"

• The authorization code expired
• Try signing in again
• Check your internet connection

Profile and Settings Issues

Can't Update Profile

You're unable to save changes to your profile.

Solutions:

1. Check name length - Ensure display name is at least 2 characters
2. Check network - Ensure stable internet connection
3. Refresh page - Refresh and try again

Settings Not Loading

The settings page won't load or shows errors.

Solutions:

1. Refresh the page - Try refreshing
2. Check network - Ensure internet connection is stable
3. Clear cache - Clear browser cache
4. Sign out and in - Sign out completely, then sign in again

Timezone Not Saving

Your timezone preference isn't being saved.

Solutions:

1. Check browser storage - Ensure localStorage is enabled
2. Don't use private mode - Private/incognito mode may not persist settings
3. Set on each device - Timezone preference is per-device

Account Deletion Issues

Can't Delete Account

You're unable to delete your account.

Possible causes:

• Confirmation text not typed correctly
• You're the only admin of an organization

Solutions:

1. Check confirmation - Type "DELETE" exactly (case-sensitive)
2. Transfer admin rights - If you're the only admin, transfer rights first
3. Contact support - If you need help with account deletion

Quick Reference

Getting More Help

If you've tried the solutions above and still have issues:

1. Check Documentation - Review other guides in this documentation
2. Contact Support - Reach out to Orkestia support with:
   • Description of the issue
   • Steps you've already tried
   • Screenshots if applicable
   • Browser and device information

Browser Compatibility

Orkestia works best with:

• Chrome (latest version)
• Firefox (latest version)
• Safari (latest version)
• Edge (latest version)

Network Requirements

Ensure you have:

• Stable internet connection - Required for authentication and API calls
• Cookies enabled - Required for session management
• JavaScript enabled - Required for the application to function