Troubleshooting Guide
This guide will help you identify and resolve common issues that may arise while using Albatross.
Login & Access Issues
Cannot Login
Problem: Unable to log into your Albatross account.
Solutions:
-
Verify your credentials
- Check that your email is correct
- Ensure caps lock is off
- Try resetting your password using the "Forgot Password" link
-
Clear browser cache
- Chrome: Settings → Privacy → Clear browsing data
- Firefox: Preferences → Privacy → Clear Data
- Safari: Preferences → Privacy → Manage Website Data
-
Try a different browser
- Use Chrome, Firefox, Safari or Edge (latest versions)
- Ensure JavaScript is enabled
- Disable browser extensions temporarily
-
Check account status
- Verify your email address is verified
- Contact your administrator if your account may be deactivated
Password Reset Issues
Problem: Not receiving password reset emails.
Solutions:
- Check spam/junk folders
- Verify you're using the correct email address
- Wait 5-10 minutes for delivery
- Contact Terrabit support if issue persists
Can't Access Workspace
Problem: Logged in but can't see your workspace.
Solutions:
- Verify you accepted the workspace invitation
- Check with your administrator that you're added to the workspace
- Ensure your account email matches the invitation email
- Try refreshing the page or logging out and back in
Can't Access Team
Problem: Can see workspace but can't access a specific team.
Solutions:
- Verify you're a member of the team
- Check your team permissions with your administrator
- Ensure the team is active (not deactivated)
Map & Display Issues
Map Not Loading
Problem: The map view shows blank or doesn't load.
Solutions:
-
Check internet connection
- Test your connection speed
- Try a different network
-
Clear browser cache
- Clear cached data and reload the page
-
Check browser compatibility
- Use a supported browser (Chrome 90+, Firefox 88+, Safari 14+, Edge 90+)
- Update to the latest version
-
Disable extensions
- Ad blockers or privacy extensions may interfere
- Try incognito/private mode
Areas Not Displaying
Problem: Areas don't appear on the map.
Solutions:
- Zoom out to see all areas
- Check area group filters - clear any active filters
- Verify areas exist for the selected team
- Refresh the page
Slow Map Performance
Problem: Map is slow to load or respond.
Solutions:
- Close other browser tabs
- Reduce the number of visible layers
- Zoom in to reduce rendered areas
Order Issues
Can't Create Order
Problem: Unable to create a new order.
Solutions:
- Verify you have "Can manage orders" permission
- Ensure you have a team selected
- Check that at least one area exists for your team
- Verify a billing account is configured for your workspace
Can't Add Deliverables
Problem: Unable to add deliverables to an order.
Solutions:
- Ensure the order is in "Draft" status
- Verify areas exist for your team
- Check that required fields are filled
- Refresh the page if the interface is unresponsive
Can't Submit Order
Problem: The submit button is disabled or submission fails.
Solutions:
- Verify at least one deliverable is added
- Check that all required fields are complete
- Ensure sufficient credit balance
- Verify a billing account is selected
Order Rejected
Problem: Your order was rejected during review.
Solutions:
- Review the rejection reason provided
- Address the issues identified
- Create a new order with corrections
- Contact Terrabit if the rejection is unclear
Insufficient Credits
Problem: Error about insufficient credits when creating or submitting order.
Solutions:
- Check your team's current credit balance
- Contact your Terrabit account manager for more credits
- Reduce the order scope to fit available credits
- Wait for pending order credits to be released
Team & Permission Issues
Can't Invite Team Members
Problem: Unable to send team invitations.
Solutions:
- Verify you have "Can manage team users" permission
- Check the email address is valid
- Try a different email address
Team Members Can't See Content
Problem: Invited members can't access team areas or orders.
Solutions:
- Verify the invitation was accepted
- Check their assigned permissions
- Ensure they have at least one permission enabled
- Have them log out and back in
Permission Changes Not Taking Effect
Problem: Updated permissions don't seem to apply.
Solutions:
- Ask the user to refresh their browser
- Have them log out and back in
- Verify the changes were saved
- Check for conflicting workspace-level permissions
Data & Download Issues
Can't Download Files
Problem: Unable to download delivered assets.
Solutions:
-
Check browser settings
- Verify downloads aren't blocked
- Check download location settings
-
Try a different browser
- Some browsers handle large downloads better
-
Check internet connection
- Large files require stable connection
- Try during off-peak hours
Download Incomplete
Problem: Downloaded files are corrupted or incomplete.
Solutions:
- Re-download the file
- Check available disk space
- Verify file size matches expected size
Can't Open Downloaded Files
Problem: Files download but won't open in GIS software.
Solutions:
- Verify the file downloaded completely
- Check file format compatibility
- Try opening in a different GIS software.
Browser-Specific Issues
Safari Issues
Common problems and solutions:
- Enable JavaScript in preferences
- Clear website data
- Disable "Prevent cross-site tracking" temporarily
Chrome Issues
Common problems and solutions:
- Clear cache and cookies
- Disable extensions in incognito mode
- Update to latest version
Firefox Issues
Common problems and solutions:
- Clear cache and site data
- Check Enhanced Tracking Protection settings
- Update to latest version
Error Messages
"Something Went Wrong"
Generic error message.
Steps:
- Note what action triggered the error
- Refresh the page
- Try the action again
- Check browser console (F12) for details
- Use the Support button to submit errors to the Terrabit Team.
"Permission Denied"
Access is restricted.
Steps:
- Verify you're logged in
- Check you have appropriate permissions
- Contact your team/workspace administrator
- Request the needed permission level
"Network Error"
Connection issues detected.
Steps:
- Check internet connection
- Disable VPN/proxy temporarily
- Try a different network
- Wait and retry
"Session Expired"
Your login session has timed out.
Steps:
- Refresh the page
- Log in again
- Your order will be saved and be in draft
Getting Additional Help
Before Contacting Support
Gather this information:
- What you were trying to do
- Error messages (screenshots helpful)
- Browser and version
- Operating system
- Steps to reproduce the issue
Contact Options
-
Click Support
- Include detailed description
- Attach screenshots if relevant
-
Documentation
- Search this documentation
- Check the Quick Start Guide
- Review relevant User Guide sections
Providing Feedback
Have suggestions or found documentation errors?
- Contact Terrabit with your feedback (Directly or under Support)
- Help us improve the platform for everyone
Quick Reference
Common Quick Fixes
| Issue | Quick Fix |
|---|---|
| Page not loading | Refresh browser (Ctrl+R / Cmd+R) |
| Changes not showing | Clear cache and refresh |
| Logged out unexpectedly | Log back in |
| Slow performance | Close other tabs, check connection |
Many issues can be resolved by clearing your browser cache and refreshing the page. Try this first!