Unity Hub not opening? Fix blank screen, login loop, and stuck loading (Windows/macOS/Linux)

Last Updated: September 20, 2025 · A complete, step-by-step guide to fixing Unity Hub startup issues, including crashes, blank screens, infinite login loops, and unresponsive behavior

Quick Fix Summary

1. End background processes — Terminate all Unity Hub processes in Task Manager or Activity Monitor
2. Check network, version, and login — Verify internet connection, update Hub to latest version, logout and re-login
3. Examine log files — Check Unity Hub log files to identify error causes
4. Reset Hub data — Clear Unity Hub cache and configuration files in user directory
5. Complete reinstall — If issues persist, uninstall Hub and reinstall latest version from official site

Table of Contents

• Common Symptoms
• Pre-Check Items
• Solutions
  • End Processes
  • Network, Update & Login Check
  • Log File Analysis
  • Hub Data Reset
  • Complete Reinstall
• Visual Guide
• Frequently Asked Questions
• Official References

Unity Hub Common Symptoms

• No response when double-clicking or briefly loads then disappears
• Only shows black screen or blank screen
• Infinite loading on login screen
• Hub starts up then suddenly crashes

Pre-Check Items (30-Second Check)

• Verify your OS and graphics drivers are up to date
• Check if corporate networks, VPNs, proxies, or security software are blocking Unity Hub
• If issues started after a recent Hub update, try re-login and verify update status

Solutions

1. End Background Processes

Unity Hub may be running in the background or have leftover processes causing conflicts.

Windows:
Ctrl+Shift+Esc → Open Task Manager → Processes tab → End all Unity Hub and Unity related processes

macOS:
Cmd+Space → Spotlight → Search "Activity Monitor" → Force quit all Unity Hub related processes

2. Network, Update & Login Verification

• Network Connection: Test internet stability. On corporate networks or behind proxies, allowlist Unity endpoints and required ports:
  • Domains: unity.com, unity3d.com, id.unity.com, api.unity.com, accounts.unity3d.com, license.unity3d.com, activation.unity3d.com
  • Ports: Outbound 443 (HTTPS), 53 (DNS); Localhost TCP 39000 for Editor↔Hub communication
• Hub Updates: Check for updates in Unity Hub menu and restart. See official installation guide
• Account Re-login: Sign out of Unity Hub completely and sign back in

3. Log File Analysis

Unity's official documentation provides Hub log paths to help identify error causes:

• Windows: %UserProfile%\AppData\Roaming\UnityHub\logs\info-log.json
• macOS: ~/Library/Application Support/UnityHub/logs/info-log.json
• Linux: ~/.config/UnityHub/logs/info-log.json

Open this file with a text editor and search for keywords like network, license, update, permission, token, or HubState.json.

Visual Guide

Windows · Unity Hub log folder (Path: %UserProfile%\AppData\Roaming\UnityHub\logs)

4. Hub Data Reset

Windows Reset Method

1. Win+R → Type %UserProfile%\AppData\Roaming → Press Enter
2. Find UnityHub folder and rename to UnityHub.bak
3. Also check %LocalAppData% → Rename UnityHub folder there

macOS Reset Method

1. Finder → "Go" → "Go to Folder"
2. Type ~/Library/Application Support → Rename UnityHub folder to UnityHub.bak
3. Also check ~/Library/Caches → Rename UnityHub folder if present

Important: Do not delete these folders—just rename them. This allows restoration if needed.

5. Complete Reinstall

1. Uninstall: Remove Unity Hub completely via system uninstall
2. Clean Folders: Ensure %AppData%\UnityHub and %LocalAppData%\UnityHub are removed/renamed before reinstall
3. Restart: Reboot system to clear remaining files
4. Reinstall: Download latest Hub from Unity's official page

Frequently Asked Questions

Q1. What should I check first when Hub won't start?

Use Task Manager or Activity Monitor to end processes, verify internet and Hub version, then check info-log.json for error messages.

Q2. Is it safe to reset cache and settings?

Yes, safe for your projects. It resets Hub sign-in and preferences only. Renaming to .bak allows easy recovery.

Q3. Should I clear package cache too?

Hub issues are usually network or Hub data. If errors persist, check Unity Package Manager cache (e.g., Windows: %LOCALAPPDATA%\Unity\cache\upm, macOS: ~/Library/Caches/Unity/upm).

Q4. What about corporate networks?

Firewalls/proxies may block Unity servers. Ask IT to allowlist Unity domains and ports, or test with a personal hotspot.

Official Documentation References

1. Unity Hub Log Locations — Log Files | Unity Hub
2. Unity Hub Startup Troubleshooting — Unity Support: I cannot open the Unity Hub
3. Unity Hub Installation — Install Hub | Unity Docs

Conclusion

Unity Hub startup issues usually stem from background processes, network restrictions, or corrupted cache. These steps resolve most cases. If problems persist, contact Unity Support with log files attached.