Articles with the tag:
Try in the cloud
Try in the cloud
Help Center
Control Panel

Migrating Nextcloud data to ONLYOFFICE Workspace

Control Panel v3.5 ONLYOFFICE Control Panel changelog

Version 3.5.2

Release date: 02/29/2024


  • Added the ability to restrict access rights to the application files for the Others group.
  • Fixed issue with redirect to the portal main page when opening Control Panel after a day on Ubuntu 22.10.
  • Fixed retrieving data error when opening the backup page.
  • Fixed issue when backup with Mail is not performed after disabling and enabling encryption (added text about stopping services and the instruction to the Help Center).
  • Fixed issue when features are not saved to the new tariff when setting a quota for the portal.
  • Edited sources build.

Version 3.5

Release date: 03/14/2023


  • Changed API methods for migration, implemented progressQueue.
  • Changed settings for connecting third-party storages. Added tooltips for fields. Added the 'Server Side Encryption Method' block for Amazon AWS S3.
  • Added logos for dark theme in the Branding section. Logos for the About page are now separate fields in the Advanced tab.
  • Added the ability to set the portal memory quota.

Version 3.1.1

Release date: 08/08/2022


  • Fixed issue with file indexing.
  • Fixed elasticsearch container errors when updating ONLYOFFICE Groups.
  • Fixed issue with brand logos after updating in the Docker installation.
  • Fixed texts and layout for the Migration feature.

Version 3.1

Release date: 05/25/2022


  • Added the Data Import page that allows to import data from Nextcloud, ownCloud and GoogleWorkspace to ONLYOFFICE Workspace.
  • Moved Elasticsearch to a separate container.
  • Fixed bugs.

Version 3.0

Release date: 06/07/2021


  • License agreement dialog when installing docker components added.
  • The inactive button with an action for uninstalled components (downloading and installing the available version) fixed.


  • Indexing progress display added.

LoginHistory and AuditTrail

  • New empty screens added.


  • New checks when restoring data from a local or a 3rd party storage.


  • SSOAuth was removed from Control Panel. It's now available as a portal setting in Community Server.

General improvements and bug fixes

  • Bugs 47721, 49101, 49187, 49273, 49272, 49324, 46386, 49585 from the internal bugtracker fixed.
  • 3rd party licenses and copyright updated.

Version 2.9.1

Release date: 12/10/2020

Bug fixes

  • Bug Fixes & Performance Improvements.

Version 2.9

Release date: 10/14/2020


  • Control Panel is available in the free Community version with all settings excepting the editors logo replacement;
  • Added the vsyscall check to the installation scripts when installing Mail Server on Debian with kernel 4.18.0 and later;
  • Redesign of the navigation menu: added Common and Portal settings sections, added icons to menu items;
  • Added the advanced rebranding page in the Common Settings;
  • Added the possibility to reindex the full-text search;
  • Updated node.js, updated packages (transition to samlify for SSO);
  • Added the Encryption at rest block in the Storage section;
  • Added the Private Room section for the server version only;
  • Added the upgrade page with a proposal to upgrade to Enterprise Edition;
  • Added the activate page with a possibility to upload a license file;
  • Added the HideAuthPage option to the SSO settings to hide the authorization page. When the HideAuthPage option is enabled, an automatic redirect from the authorization page to the SSO service will occur.


  • Added the Sign in to domain option on the authorization page.

Single Sign-on

  • Transition to the new samlify library;
  • Added the HideAuthPage option to the SSO settings to hide the authorization page. When the HideAuthPage option is enabled, an automatic redirect from the authorization page to the SSO service will occur.

Version 2.7

Release date: 04/25/2019


  • Added more fields mapped for the users loaded via LDAP: user photo, birthday, contacts, primary phone number;
  • Added the setting to autosync LDAP on schedule;
  • Added the possibility to give administrator rights to the user group at the portal via LDAP;
  • Updated the rules for LDAP users.

Version 2.5.1

Release date: 04/07/2018


  • Fixed the Server internal error error when using the groups enclosed inside each other in the AD (bug #37414).

Single Sign-on

  • Fixed the issue when the user data between the Service Provider and the portal was transferred via HTTP only, even when HTTPS was enabled.

Version 2.4.0

Release date: 01/13/2018

Single Sign-on

  • Fixed the Invalid ssoConfig error which occurred when the link to the IdP contained the question mark '?', e.g.: IdP Single Sign-On Endpoint URL:;
  • Fixed the Invalid authentication token error which prevented from adding a user to the portal using the AD FS, in case the + or - characters were present when sending the encrypted data.

Version 2.3.0

Release date: 12/15/2017


  • Added the changelog for Control Panel and link to it;
  • Fixed the bug when JWT parameters were not sent when updating Document Server(bug #36270);
  • Fixed the bug when Audit Trail heading was present at the login history page (bug #36026);
  • The current machine is now checked for being linked with the domain name for multiple portals.


  • Fixed the bug with the LDAP Domain not found error which occurred if the DN record had no DC records (the users with Sun/Oracle DS were affected); now if the LDAP domain could not be specified, the LDAP domain will acquire the unknown value or the ldap.domain value from the web.appsettings.config configuration file;
  • Fixed the bug with the Sizelimit Exceeded error when trying to get more than 1000 users from the Active Directory;
  • Increased the login speed with the Group Membership setting enabled;
  • Added additional logging;
  • Fixed the bug with LDAP operation hanging when using Mono v5.2.0 and older;
  • Fixed the bug with the error when trying to login using the email address entered in the fields different from the Mail Attribute;
  • Fixed the bug occurring in the enclosed groups, when the users were displayed not in all groups.

Version 2.2.0

Release date: 10/31/2017


  • Added the script launch when updating the document-server for the correct edited document saving.


  • Dramatically changed LDAP integration, migrated to the single library for the work with LDAP (Novell.Directory.Ldap.NETStandard, Nuget, MIT);
  • Login and email are now split into two separate fields;
  • Added the support for big data;
  • Increased the work speed via the LDAP protocol (the connection to the server and receiving the data is now made once per session, added the limits when only a certain number of results is necessary, fixed the slow login for bit data, removed the sorting out used to find the SID parameter);
  • Fixed the user re-creation issue;
  • Fixed the duplicate username issue;
  • Fixed the already existing email issue;
  • Replaced the LDAP user deletion with account deactivation (for further data migration and data safety);
  • Instead of re-creating a user with an unknown SID but an existing email the data is updated;
  • Added the attempt to save the correct UserName/Login in case a similar one is already taken on the portal.

Single Sign-on

  • Added the AD FS support;
  • Replaced the Single Sign-on link at the authorization page with the customizable button, added the button customization to the SSO setting of the Control Panel.

Version 2.1.0

Release date: 07/03/2017


  • Added the support of letsencrypt service for the domain certificate generation.

Single Sign-on

  • Added the new sso.auth service;
  • Added the new SSO settings page;
  • Added the support for Shibboleth.

Version 2.0.0

Release date: 05/25/2017


  • The Control Panel migrated from MVC to Node.js.

Version 1.6.0

Release date: 12/05/2016


  • Added LDAP synchronization for users and groups when saving the settings, after login and using the Sync button;
  • Changed email formation for LDAP users;
  • Fixed the problem of creation of users with invalid emails;
  • Fixed the problem of duplicate users;
  • Added icons and hints to the users in the list for the admin;
  • Blocked for editing the user profile fields imported using LDAP;
  • Added the real LDAP password saving to the database during login in case LDAP Auth is disabled, now the LDAP users will become common portal users when LDAP Auth is disabled;
  • Added new API Settings method - Sync LDAP;
  • Added new translations;
  • Bug fixes.

Version for Windows

  • Made changes at the Update page for the Control Panel for Windows;
  • Updates are performed using the downloaded installation packages for each module.
  • The current installed component version numbers are obtained via API request to the Community Server.
  • The new versions available for download are obtained via the request to the file, where all the latest component version numbers and links for their download are stored in the JSON format.


In this article, we will show you how to transfer the data from the Nextcloud server to your ONLYOFFICE portal.

Starting from ONLYOFFICE Workspace 12.0.0. you can export users, their files, and sharing settings to your portal.

Export data from Nextcloud

Enabling the maintenance mode

First, you need to enable the maintenance mode on your Nextcloud server. The maintenance mode stops the server and allows us to export data from the Nextcloud installation folder and MySQL database. To activate the maintenance mode:

  1. Go to the folder with the Nextcloud installation.
    cd /var/www/html/nextcloud
  2. Run the occ file to enable the maintenance mode.
    sudo -u www-data php occ maintenance:mode --on
    Depending on the operating system, the location of the Nextcloud installation folder might differ.

Exporting the data folder

To successfully migrate your data to ONLYOFFICE Workspace, we need to include users' folders in our backup archive. They are located in the data folder within the Nextcloud directory.

To export the data folder run the following command:

sudo rsync -Aax /var/www/html/nextcloud/data [preferred location]/data/

Where [preferred location] is a destination of the exported folder.

Exporting the database

Also, we need to export the MySQL backup file. There are two possible ways of dumping the database.

In case the database is deployed on the same server, execute:

sudo mysqldump --lock-tables -u root -p nextcloud_db > [preferred location]/nextcloud-dirbkp_`date +"%Y%m%d"`/

Where [preferred location] is a destination of the exported folder.

If the database is deployed on a different server, run the following command:

mysqldump --single-transaction -h [server] -u [username] -p[password] [db_name] > nextcloud-sqlbkp_`date +"%Y%m%d"`.bak

Disabling the maintenance mode

After all the necessary folders and files have been exported, we can disable the maintenance mode and start the Nextcloud server.

To do that, go to the Nextcloud installation folder and execute:

sudo -u www-data php occ maintenance:mode --off

Prepare the data for import

In order to import the data, you need to compress certain files and folders to a zip archive. The file contains the data folder which stores the folders of the Nextcloud users and the database backup file. The structure of the file looks as follows:

    - data:
        - user1
        - user2
        - user3
    - MySQL backup file
We recommend storing only users' folders within the data directory. Storing the remaining files and folders within this directory might cause mistakes when importing the data.

Import the data to ONLYOFFICE Workspace

  1. Log in to your ONLYOFFICE Workspace.
  2. Go to the Control Panel.
    Creating Backup automatically Creating Backup automatically
  3. Choose the Data import from the PORTAL SETTINGS section.
    Creating Backup automatically Creating Backup automatically
  4. Click the INITIALIZE IMPORT button in the Nextcloud section.
    Creating Backup automatically Creating Backup automatically
  5. Click the Plus button next to the selection box and select the file.
    Creating Backup automatically Creating Backup automatically

    Wait for the archive to load. When the loading is complete, click the UPLOAD TO SERVER button.

    Creating Backup automatically Creating Backup automatically
  6. Select the list of users to be imported into ONLYOFFICE and click the NEXT STEP button. In this step, only users with e-mails will be migrated.
    Creating Backup automatically Creating Backup automatically
  7. In this step, you can select not filled e-mail users. You can fill in their e-mail addresses and migrate them to your portal. To do that, fill in the user's e-mail address. Click the Tick button next to the e-mail text box. Select several users from the list by ticking users' checkboxes. Proceed to the next step by clicking the NEXT STEP button.
    Creating Backup automatically Creating Backup automatically

    Also, there is an option to download the unimported users by clicking the DOWNLOAD UNIMPORTED USERS button.

  8. Select modules for import. These modules will appear in the corresponding modules of ONLYOFFICE. Click the START DATA IMPORT button to proceed with the final step.
    Creating Backup automatically Creating Backup automatically
  9. After the data is migrated, click the FINISH button to complete the data import.
    Creating Backup automatically Creating Backup automatically

Optionally, you can send a welcome letter to the imported users. This letter will inform your Nextcloud users about migration to ONLYOFFICE Workspace. It contains a brief description of the main features and a login link. To send the letter, check the Send Welcome Letter option before clicking the FINISH button.

Creating Backup automatically Creating Backup automatically

After the migration is complete, the new users can be found in the People module.

Creating Backup automatically Creating Backup automatically

And their files with the imported sharing settings can be accessed through the Documents module.

Creating Backup automatically Creating Backup automatically
How to use the backup/restore feature
Download Host on your own server Available for
Docker, Windows and Linux
You Might Also Like This: