Skip to end of metadata
Go to start of metadata

As an administrator, you can provide preview tools to your users so that they can quickly view a portion of a document to determine if it is the one they need to work with. 

 1. After selecting a file in the User Portal, a Preview button is available.

 2. After clicking the Preview button,
a separate window opens showing an image of the file.

This preview image cannot be edited.

There are three ways an administrator can provide preview tools in FileCloud:

  • Enable Quick JS Preview (FileCloud version 19.1 and later)
  • DocConverter with LibreOffice (FileCloud version 18.2 and earlier)
  • WOPI - Web Application Open Platform Interface Protocol (Supports online web editing features)

 What is DocConverter?

FileCloud uses a Java-based service called FileCloud Document Converter to:

  • Enable thumbs for all Microsoft Office documents (DOC, DOCX, PPT, PPTX, XSL, XSLX)
  • Enable thumbs for Adobe documents (AI, PDF, PSD)
  • Enable thumbs for TIFF images
  • Interface with LibreOffice for document preview generation

For this FileCloud uses a java program based on Apache's PDFBox.  Document converter also will use LibreOffice libraries to convert documents to PDF.

Need more help? If you have contacted support you can perform Advanced Troubleshooting for Document Converter

FileCloud Server version 19.1 and later already includes the Doc Converter jar file and it is installed automatically. 

  • You do not need to download it as you did in earlier versions.

(warning)  In FileCloud version 19.1 and later, Document Converter for Windows is automatically installed and ready to enable in the Admin Portal.  

1.   If you are running on Linux, start Doc Converter on your server.

FileCloud Document Converter for Ubuntu 

FileCloud Document Converter for CentOS

2.   Enable thumbnail images on the Admin Portal.

Enable Document Thumbs

 What Other Online Web Editing Features Are Available?

Administrators can configure online editing to allow FileCloud users to select any supported document and edit the document from within the User Portal.

  • FileCloud uses the WOPI (Web Application Open Platform Interface) protocol to support online web editing

To use WOPI, you must install or have already available one of the following to provide the web editing capability:

  • Microsoft Office Online
  • Collabora Code

Manage Online Web Editing

You can choose which tool to use not only by the versionof FileCloud you are using, but also by the functionality.

ToolFile Types PreviewedPreview Keys  Interactions with Other Tools
Quick JS Preview
  • DOCX
  • PPTX
  • XLSX
  • If DocConverter is also in use, then previews can also be shown by using the SHIFT + Preview keys for a DocConverter view
  • If WOPI is also in use, then WOPI will override QuickJS functionality
DocConverter with LibreOffice
  • TXT
  • ODT (Apache OpenOffice and LibreOffice)
  • ODG (Oasis graphic files)
  • ODS (Oasis Spreasheets)
SHIFT + Preview
  • If Quick JS is also in use, then previews can also be shown without using any preview keys
  • If WOPI is also in use, then WOPI will override DocConverter functionality
SHIFT + Preview WOPI will override any Quick JS or  DocConverter functionality

(lightbulb) To configure document preview, click on a method to see the steps:

 Configure Quick JS Preview for FileCloud 19.1 and Later

PRE-REQISITES for Quick JS Previews:

  1. You must be running FileCloud Server version 19.1 and later.
  2. You must stop the Document Converter service according to the OS you are using.
    1. For Windows, open the FileCloud Control Panel and stop the DocConverter Service if it is running.
    2. For Linux, run the following command:

      # sudo service fcdocconverter stop

To provide a preview using Quick JS:

  1. Open a browser and log in to the Admin Portal.
  2. From the left navigation panel, under SETTINGS, click Settings.
  3. On the Manage Settings  window, select the Misc.  tab, and then the Preview  tab.
  4. On the Preview screen, next to Enable Quick JS Preview, select the checkbox. 

 Configure Document Preview for FileCloud 18.2 and Earlier

     1.  Install OpenJDK:


 1.   Download Open JDK 8 from


 2.   Create a new folder in the C: directory.

(In the example diagram, jdk8u192-b12 is the name of the new folder.)

3.   Extract the Open JDK file you downloaded into the new folder.

     2.  Install Document Preview

             a.  Open FileCloud Control Panel.

             b.  To install Document Preview, click Install.

     3.  Start the Service:

               a.  Open FileCloud Control Panel.

               b.  To start the Document Preview service, click Start.

     4. Configure FileCloud

  If you are running the multi-site configuration, please follow these steps on the root site.

               a.  Open a browser and log in to the Admin Portal.

               b.  From the left navigation panel, under SETTINGS click Settings.

               c.  On the Manage Settings screen, select the Misc. sub-tab.

               d.  In Office Location, type in the correct path for the Libre Office portable installation. Normally you would type in the following path:


                e.  Next to Enable FC Document Converter , select the checkbox.

 Configure Preview using WOPI

Administrators can configure online previewing using WOPI for any supported document from within the User Portal.

  1. In the Admin UI, go to Settings > Web Edit tab.
  2. Configure online editing using WOPI at 
    Microsoft Office Online Cloud For Web Edit
  3. During your configuration, check WOPI Preview.

  • No labels