How to update workspace (CE)?

Do you want to: Ask a how-to question
Community Server/Control Panel version:
Type of installation of Workspace (docker, deb/rpm, exe): docker using workspace-install.sh
OS: Debian 10
Browser version: various

Hi,

first of all thank you very much for this fantastic project. I am using it while phasing my MS subscription out and there is little to be desired.

I am using the Workspace CE and installed it via workspace-install.sh. Now I am wondering how to update the installation.

I am aware that I can update “something” from the Control Panel. But I am uncertain whether this only updates the apps themselves or also the docker containers inside which they run.

Could someone please clarify that for me?

Thanks!

Hello! @onlywolfe

The WorkSpace consists of several main parts:

  • Community Server

  • Document Server

  • Control panel

You can update them directly through the Control Panel - Updating ONLYOFFICE Workspace to the latest version - ONLYOFFICE

You must have a script file on your host, in which case you can update using the command - bash workspace-install.sh -u true

You can read about the -u true flag in our HelpCenter.

https://helpcenter.onlyoffice.com/installation/workspace-install-docker.aspx

If you do not have a mail server installed, then, you need to use the command - bash workspace-install.sh -u true -ims false

Thank you Russell!

Can you confirm whether updating via Control Panel will update the docker containers (vs only updating the components running inside those containers)?

(I understand from your link that updating using the -u true flag will update the docker containers.)

Thanks again!

Bonus question :slight_smile:

When I try to update via bash workspace-install.sh -u true, I get an error message that the minimum installation requirements are not met (min. 40960 MB free hdd space).

Now, I understand that there is a check for the initial installation, because that takes (a lot of) space. But after installation, obviously that space is taken. Do I really need to make another 40GB available just for updating? I would hope the update does not need all that space again…?

Thanks!

Hello @onlywolfe,

Yes, it just simply removes the old container and installs a new one in its place. Portal data such as files, users, etc. are mapped on the host, so they will remain, but, we recommend you create a backup or snap of your whole server before updating it.

You have to run the script with -skiphc true flag, this flag disabling the hardware checking. You can check all flags using the script bash workspace-install.sh -h

Perfect! Thank you.

It went through fine this way, telling me that all containers were already the latest version, because I had updated via Control Panel a couple of days ago.

Regarding the -skiphc true flag I was worried that the update might require more free space than I had available and then get stuck, if there is no check at all. Can you tell me how much space needs to be free for the update?

Thanks!

Hello @onlywolfe!

It depends on the docker image sizes. You can check it out on https://hub.docker.com, for example:

https://hub.docker.com/r/onlyoffice/documentserver/tags

https://hub.docker.com/r/onlyoffice/communityserver/tags

Also, please note that you can remove old docker images when the update process is completed.

NB! We always recommend preparing the whole server backup before the update process just in case.