Warning: This Help page is relevant to LibreOffice up to version 6.0.
For updated Help pages, visit https://help.libreoffice.org.

Starting the LibreOffice Software With Parameters

From LibreOffice Help
Jump to navigation Jump to search

By starting the LibreOffice software from the command line you can assign various parameters, with which you can influence the performance. The use of command line parameters is only recommended for experienced users.

Note.png For normal handling, the use of command line parameters is not necessary. A few of the parameters require a deeper knowledge of the technical background of the LibreOffice software technology.

Starting the LibreOffice Software From the Command Line

  1. Under Windows, select Run from the Windows Start menu, or open a Shell under UNIX® based platforms.
  2. Under Windows, type the following text in the Open text field and click OK.
  3. Under UNIX based systems, type the following line of text, then press Return:
    {install}/program/soffice {parameter}}
    Replace {install} with the path to your installation of the LibreOffice software (for example, C:\Program Files\Office, or ~/office)
    Where required, replace {parameter} with one or more of the following command line parameters.

Valid Command Line Parameters

Parameter Meaning
-help / -h / -? Lists the available command line parameters to the console.
-writer Starts with an empty Writer document.
-calc Starts with an empty Calc document.
-draw Starts with an empty Draw document.
-impress Starts with an empty Impress document.
-math Starts with an empty Math document.
-global Starts with an empty Writer master document.
-web Starts with an empty HTML document.
-show {filename.odp} Starts with the Impress file {filename.odp} and starts the presentation. Enters edit mode after the presentation.
-minimized Starts minimized. The splash screen is not displayed.
-maximized Starts maximized.
-invisible Starts in invisible mode.

Neither the start-up logo nor the initial program window will be visible. However, the LibreOffice software can be controlled and documents and dialogs opened via the API.

When the LibreOffice software has been started with this parameter, it can only be ended using the taskmanager (Windows) or the kill command (UNIX based systems).

It cannot be used in conjunction with -quickstart.

More information is found in the LibreOffice Developer's Guide.

-nocrashreport Disables the error report tool.
-norestore Disables restart and file recovery after a system crash.
-nofirststartwizard Disables the Welcome Wizard.
-quickstart Activates the Quickstarter.
-accept={UNO string} Notifies the LibreOffice software that upon the creation of "UNO Acceptor Threads", a "UNO Accept String" will be used.

More information is found in the LibreOffice Developer's Guide.

-env Sets another environment for the program start.

Use soffice -env:UserInstallation=$(URL) where $(URL) is the URL of a folder that contains the "user" folder.

-p {filename1} {filename2} ... Prints the files {filename1} {filename2} ... to the default printer and ends. The splash screen does not appear.

If the file name contains spaces, then it must be enclosed in quotation marks.

-pt {Printername} {filename1} {filename2} ... Prints the files {filename1} {filename2} ... to the printer {Printername} and ends. The splash screen does not appear.

If the file name contains spaces, then it must be enclosed in quotation marks.

-o {filename} Opens {filename} for editing, even if it is a template.
-view {filename} Creates a temporary copy of {filename} and opens it read-only.
-n {filename} Creates a new document using {filename} as a template.
-nologo Disables the splash screen at program start.
-nodefault Starts without displaying anything except the splash screen.
-nofirststartwizard Add this parameter to the program start command to suppress the Welcome Wizard.
-display {display} Sets the DISPLAY environment variable on UNIX based platforms to the value {display}. This parameter is only supported by the start script for the LibreOffice software on UNIX based platforms.
-headless Starts in "headless mode" which allows using the application without user interface.

This special mode can be used when the application is controlled by external clients via the API.