Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/uazo/cromite/llms.txt

Use this file to discover all available pages before exploring further.

This guide covers common issues you may encounter while using Cromite and their solutions.

​
Performance Issues

Cause: JavaScript JIT is disabled by default for security.Solution:
1

Identify JIT-dependent site

Sites with heavy JavaScript usage may perform poorly without JIT compilation.
2

Enable JIT for the site

Follow the JIT Configuration guide to enable JIT selectively for that site.
3

Test performance

Reload the page and verify improved responsiveness.
Only enable JIT for sites you trust. See JIT Configuration for security implications.
Possible causes:
  • JavaScript JIT disabled
  • Ad blocker blocking video resources
  • DRM content (not supported)
Solutions:
  1. Enable JIT: Some video players require JIT for optimal performance
  2. Check ad blocker: Visit chrome://adblock and temporarily disable for the site
  3. Check for DRM: Cromite does not support DRM-protected content (Netflix, Spotify, etc.)
If a video requires DRM (Widevine), it will not play in Cromite. Use a different browser for DRM content.
Cause: WebAssembly requires JIT to be enabled.Solution:Enable JavaScript JIT for the site:
  1. Tap the lock icon in the address bar
  2. Go to Site settings → JavaScript JIT
  3. Change to Allowed
  4. Reload the page
WebAssembly is commonly used in online IDEs, games, and high-performance web applications.

​
Ad Blocking Issues

Cause: Filter lists may be outdated or incomplete.Solutions:
1

Check filter lists

Navigate to chrome://adblock and verify your active filter lists.
2

Update filter lists

Ensure filter lists are up to date (may update automatically).
3

Enable additional lists

Consider enabling additional filter lists for better coverage.
4

Report the issue

If ads persist, report to the filter list maintainer (EasyList, uBlock filters, etc.), not Cromite.
Cromite uses public filter lists. Issues with specific ads should be reported to the list maintainers.
Cause: Ad blocker may be blocking legitimate resources.Solutions:
  1. Whitelist the site: Go to chrome://adblock and add the site to exceptions
  2. Disable ad blocking for site: Use Site Settings to disable ad blocking per-site
  3. Check specific rules: Some filter rules may be too aggressive
1

Open Site Settings

Tap the lock icon → Site settings.
2

Disable ad blocking

Find Ad blocking and change to Allowed.
3

Reload page

Refresh to see if the issue is resolved.

​
DRM and Media Issues

Cause: Cromite does not support DRM media.Explanation:DRM (Digital Rights Management) is disabled in Cromite because:
  • Unclear whether DRM licenses are bound to the device
  • No clear way to delete DRM licenses
  • Privacy concerns about external DRM service connections
Solution:
DRM support cannot be enabled in Cromite. Use a different browser for DRM-protected content.
Affected services:
  • Netflix
  • Spotify Web Player
  • Amazon Prime Video
  • Disney+
  • Most streaming platforms
  • Some audiobooks and ebooks
Cause: Limited codec support due to licensing.Supported formats:
  • ✓ H.264 video
  • ✓ AAC audio
  • ✓ HEVC (enabled by default)
  • ✓ JXL images
  • ✗ Proprietary DRM formats
Solution:If a media format is not supported, consider:
  1. Finding an alternative source with supported formats
  2. Converting media to supported formats
  3. Using a native media player app

​
Push Notifications

Cause: Cromite disables Google Cloud Messaging (GCM) integration.Explanation:The Chromium Blink engine uses GCM to deliver push notifications via the Push API. This requires Google services, which are disabled in Cromite for privacy.Solution:
Push notifications cannot be enabled in Cromite due to Google service dependencies.
Alternatives:
  • Use native apps for services requiring push notifications
  • Check sites manually for updates
  • Enable browser-based polling if available

​
PWA and TWA Issues

Cause: TWA/PWA installation is not supported.Explanation:Trusted Web Activities (TWAs) are generated server-side on googleapis.com, which is blocked in Cromite.Alternative:Cromite supports home shortcuts that launch websites without browser UI:
1

Open Menu

Tap the menu button (three dots) in Cromite.
2

Add to Home Screen

Select Add to Home screen.
3

Create Shortcut

Enter a name and confirm to create a home screen shortcut.
Home shortcuts open the browser without UI but don’t have the same integration as full PWAs.

​
External App Integration

Cause: Custom Tab intents are disabled by default.Explanation:Custom Tabs can pass tracking information between apps and the browser, linking your app usage with web browsing.Solution:
Custom Tabs cannot be enabled in Cromite due to privacy concerns. Links from apps will open in regular browser tabs.

​
Sync and Google Services

Cause: Google Sync is disabled in Cromite.Explanation:Cromite cannot use Google APIs for:
  • Google Sync
  • Google Translate
  • Google Safe Browsing
  • Data Saver
  • IP Protection
This is a limitation of all Chromium-based projects outside of official Chrome. Additionally, these features would compromise privacy.Alternatives:
  • Export bookmarks and import manually
  • Use third-party bookmark sync services
  • Manually manage your browsing data
Cause: Google Translate is disabled.Alternatives:
  • Copy text and use a dedicated translation app
  • Visit translate.google.com directly
  • Use other translation services

​
Certificate and HTTPS Issues

Possible causes:
  • Invalid certificate
  • Corporate proxy with SSL inspection
  • TLS resumption disabled (expected behavior)
Solutions:
  1. Check certificate validity: Ensure the site’s certificate is valid and not expired
  2. Corporate environments: If using a corporate proxy with SSL inspection:
    1

    Enable user certificates

    Navigate to chrome://flags and search for “user certificates”.
    2

    Enable flag

    Enable user certificates support.
    3

    Install certificate

    Install your organization’s root certificate via Android/system settings.
User certificates are disabled by default to prevent man-in-the-middle attacks. Only enable if necessary.
Cause: Corporate networks may require:
  • User certificates for SSL inspection
  • Proxy configuration
  • VPN access
Solutions:
  • Enable user certificates (see above)
  • Configure proxy via Proxy Configuration
  • Check with your IT department for specific requirements

​
Installation and Update Issues

Solutions:
  1. Enable unknown sources:
    • Android 8+: Settings → Apps → Special access → Install unknown apps → Enable for your file manager
    • Android 7 and below: Settings → Security → Unknown sources
  2. Check architecture:
    • Download the correct APK for your device (arm64, arm32, or x86_64)
    • Most modern devices use arm64
  3. Verify download:
    • Ensure APK downloaded completely
    • Re-download if file is corrupted
Check:
1

Verify setting

Go to Settings → About Cromite and verify update notifications are enabled.
2

Check last check time

Updates are checked every 3 days automatically.
3

Manual check

Visit the releases page to verify you have the latest version.
Check chrlauncher configuration:
  1. Verify chrlauncher.ini is in the correct location
  2. Check ChromiumUpdateUrl is set correctly: 
    ChromiumUpdateUrl=https://github.com/uazo/cromite/releases/latest/download/updateurl.txt
  3. Ensure network connectivity to GitHub
  4. Check chrlauncher logs for errors
See Auto-Updates guide for complete setup.

​
Platform-Specific Issues

Cause: AppArmor restricts unprivileged user namespaces.Solutions:See Auto-Updates guide for details.
Cause: Microsoft Defender may flag Cromite as potentially unwanted.Solutions:
  1. Add exclusion:
    • Windows Security → Virus & threat protection → Manage settings
    • Exclusions → Add or remove exclusions
    • Add Cromite installation directory
  2. Specifically exclude user data directory:
    • Add the user-data-dir folder specified in chrlauncher.ini
    • Default: %LOCALAPPDATA%\Cromite\User Data
Cause: Network process sandbox not properly configured.Solution:Run this command as Administrator in the directory containing chrome.exe:
icacls . /grant "*S-1-15-2-2:(OI)(CI)(RX)"
See Auto-Updates guide for details.

​
Search and Omnibox Issues

Cause: No default search engine set.Solution:
1

Open Settings

Navigate to Settings → Search engine.
2

Select default

Choose a default search engine from the list.
3

Add custom engine

Or add a custom search engine if needed.
Cromite doesn’t set a default search engine; you choose during first launch or in settings.
Cause: Requests for single-word omnibar searches are disabled by default.Expected behavior: Single words are treated as search queries, not URLs.Workaround: Explicitly use your search engine or add the search keyword manually.

​
Import/Export Issues

Solutions:
1

Export from other browser

Export bookmarks as HTML file from your previous browser.
2

Open Cromite

Navigate to Settings → Bookmarks.
3

Import

Select Import bookmarks and choose your HTML file.
Cromite supports standard HTML bookmark format compatible with Chrome, Firefox, and others.
Solution:Android version:
1

Open menu

Tap the three-dot menu.
2

Bookmarks

Go to Bookmarks.
3

Export

Look for bookmark import/export actions in the menu.

​
General Troubleshooting Steps

1

Clear browser cache

Settings → Privacy and Security → Clear browsing dataSelect:
  • Cached images and files
  • Cookies and site data (if needed)
2

Disable extensions/flags

If you’ve enabled experimental flags or extensions, try disabling them:
  • chrome://flags → Reset all to default
  • chrome://extensions → Disable all extensions
3

Check for updates

Ensure you’re running the latest version:
4

Reset site settings

Reset permissions for problematic sites:
  • Navigate to site → Lock icon → Site settings → Reset permissions
5

Create new profile

Test with a fresh profile:
  • Android: Reinstall the app
  • Desktop: Use a different --user-data-dir

​
Getting Help

GitHub Issues

Report bugs and request features

GitHub Discussions

Ask questions and discuss usage

FAQ

Check the official FAQ

Features

Review all Cromite features
When reporting issues, include:
  • Cromite version
  • Platform (Android/Windows/Linux)
  • Device/OS version
  • Steps to reproduce
  • Expected vs. actual behavior
Before reporting an issue, search existing GitHub issues to see if it’s already known or fixed.

Build docs developers (and LLMs) love

Get started for freeTalk to us