Diagnose LibreOffice Extension Issues in Safe Mode

LibreOffice Safe Mode is a built-in troubleshooting environment that allows users to launch the application with a clean configuration, bypassing hardware acceleration, customizations, and third-party add-ons. This guide details the startup methods and specific Safe Mode options available to isolate, diagnose, and resolve issues caused by faulty or incompatible LibreOffice extensions.

Accessing LibreOffice Safe Mode

To access Safe Mode, use either the application interface or the command line:

• From the Application Menu: Open LibreOffice, navigate to Help, and select Restart in Safe Mode…. Confirm by clicking Restart.
• From the Command Line / Terminal: Launch the executable with the safe mode switch:
  • Windows: soffice.exe --safe-mode
  • Linux / macOS: libreoffice --safe-mode (or soffice --safe-mode)

Key Safe Mode Options for Extension Diagnostics

Upon launching, the Safe Mode dialog presents several targeted recovery options:

1. Continue in Safe Mode

Selecting Continue in Safe Mode starts a temporary session where all user-installed extensions, custom templates, and configuration tweaks are disabled. If LibreOffice runs normally in this state without crashing or freezing, a faulty extension or corrupted user profile is the likely cause.

2. Disable Shared and User Extensions

Located under the Disable section, the Disable shared and user extensions option prevents all installed extensions from loading during standard startup. This is the primary diagnostic choice when an extension prevents LibreOffice from opening in normal mode, as it allows you to test system stability without deleting your installed packages.

3. Manage Extensions via the Interface

While running in Safe Mode, you can access the standard interface to manually isolate problematic add-ons: * Navigate to Tools > Extension Manager. * Disable extensions individually to determine which specific add-on is causing instability. * Remove outdated, conflicting, or incompatible extensions completely.

4. Reset User Profile Settings

If disabling extensions does not resolve the issue, the extension registry or user profile configuration may be corrupted. Under the Reset to factory settings section: * Reset settings and user modifications: Resets core interface settings while preserving personal data. * Reset entire user profile: Completely wipes all installed extensions, custom dictionaries, and templates, restoring LibreOffice to its original installation state.

5. Profile Backup and Restore

Before applying destructive changes, the Safe Mode dialog includes a Create backup option. This archives your current configuration, allowing you to restore safe components after problematic extensions have been eliminated.