Home
DocSpace
Installation
Developer
Installing ONLYOFFICE DocSpace Developer with additional script parameters

Installing ONLYOFFICE DocSpace Developer with additional script parameters

Introduction

ONLYOFFICE DocSpace Developer is a paid version of a document hub where you can connect users and documents in one place to boost collaboration.

ONLYOFFICE DocSpace Developer is shipped as an automatic installation script for Linux operating systems with Docker installed. The script will set up Docker containers with all the components necessary for ONLYOFFICE DocSpace Developer correct work and is easy to run, manage and update.

After you download the ONLYOFFICE DocSpace Developer installation script, you might need to run it specifying some additional parameters, for example, if you want to install each component on a separate machine.

Use the following command to display the list of all the available Docker script parameters:

bash docspace-developer-install.sh docker -h

Use the following command to display the list of all the available DEB/RPM script parameters:

bash docspace-developer-install.sh package -h

You can find a short description and some usage examples for these parameters below.

When you run the script with parameters, you will be prompted to select the way you want to install ONLYOFFICE DocSpace. Type Y and press Enter to install ONLYOFFICE DocSpace using Docker. Type N and press Enter to install ONLYOFFICE DocSpace from DEB/RPM packages.

Credentials

Parameter	Description
`-reg, --registry`	docker registry URL (e.g., https://myregistry.com:5000)
`-un, --username`	docker registry login
`-p, --password`	docker registry password

These parameters are used in case we provide you credentials to access a test repository so that you can run containers from images stored in it.

Example

bash docspace-developer-install.sh -reg URL -un username -p password

Installation type

Parameter	Description	Values	Default
`-it, --installation_type`	installation type	`community\|developer\|enterprise`	`developer`

This parameter allows you to install the specified solution: ONLYOFFICE DocSpace Community, ONLYOFFICE DocSpace Developer or ONLYOFFICE DocSpace Enterprise.

Example

bash docspace-developer-install.sh -it community

This will install the ONLYOFFICE DocSpace Community solution.

Hardware check

Parameter	Description	Values	Default
`-skiphc, --skiphardwarecheck`	use to skip hardware check	`true\|false`	`false`

This parameter allows you to skip checking if the system meets the minimal hardware requirements.

Example

bash docspace-developer-install.sh -skiphc true

This will skip hardware check.

Component update

Parameter	Description	Values	Default
`-u, --update`	use to update existing components	`true\|false`	`false`

This parameter allows you to install the latest versions of the necessary components if the corresponding components installed on your machine are outdated.

Example

bash docspace-developer-install.sh -u true

This will consequently stop those containers that need to be updated, remove them and then run the latest versions of the corresponding ONLYOFFICE DocSpace Developer components. If the current component version coincides with the latest available one, such a container will not be affected. If you have skipped some components during the previous installation, they will also be skipped. The DocSpace data should be picked up automatically.

Update Docs only to version 7.2.1.34 and skip the update for all other components:

bash docspace-developer-install.sh -u true -docsi onlyoffice/documentserver-de -docsv 7.2.1.34 -idocs true -ids false -irbt false -irds false

Update DocSpace only to version 1.2.0 and skip the update for all other components:

bash docspace-developer-install.sh -u true -dsv v1.2.0 -idocs false -irbt false -irds false

Component installation

Parameter	Description	Values	Default
`-ids, --installdocspace`	install ONLYOFFICE DocSpace	`true\|false`	`true`
`-idocs, --installdocs`	install ONLYOFFICE Docs	`true\|false`	`true`
`-irbt, --installrabbitmq`	install RabbitMQ	`true\|false`	`true`
`-irds, --installredis`	install Redis	`true\|false`	`true`
`-imysql, --installmysql`	install MySQL	`true\|false`	`true`

These parameters allow you to specify whether you need to install a certain component or not. They can be used if you want to install each component on a separate machine.

Use the true value to install a component.
Use the false value to skip a component installation.

Example

bash docspace-developer-install.sh -idocs false

This will install all the ONLYOFFICE DocSpace Developer components without ONLYOFFICE Docs.

bash docspace-developer-install.sh -ids false -idocs true -imysql false -irbt false -irds false

This will skip the installation of ONLYOFFICE DocSpace, MySQL, RabbitMQ, and Redis and will install ONLYOFFICE Docs only.

Component version

Parameter	Description
`-dsv, --docspaceversion`	ONLYOFFICE DocSpace version
`-docsv, --docsversion`	ONLYOFFICE Docs version

These parameters can be used to install a certain ONLYOFFICE DocSpace or ONLYOFFICE Docs version if for some reasons you do not want to install the latest version available in the repository. By default, an image tagged as latest is used to run the component container.

Example

Open the Docker Hub repository in your browser, select ONLYOFFICE Docs and go to the Tags tab to view all the tags available in the repository. Specify the version you want to install:

bash docspace-developer-install.sh -docsv 7.2.1.34

This will install ONLYOFFICE DocSpace with the ONLYOFFICE Docs 7.2.1.34 version.

ONLYOFFICE Docs image name

Parameter	Description
`-docsi, --docsimage`	ONLYOFFICE Docs image name

This parameter can be used to specify a name of the ONLYOFFICE Docs image that a container should be started from. The specified image should be stored in our official public repository on Docker Hub.

Example

bash docspace-developer-install.sh -docsi onlyoffice/documentserver-de

This will run a container from the specified ONLYOFFICE Docs image stored in the repository.

Setting for hosts

Parameter	Description
`-dsh, --docspacehost`	ONLYOFFICE DocSpace host
`-esh, --elastichost`	Elasticsearch hosts

These parameters can be used to connect the components if you install them on separate machines.

Example

bash docspace-developer-install.sh -esh 192.168.3.202

This will install ONLYOFFICE DocSpace and connect it with Elasticsearch installed on a different machine which has the 192.168.3.202 IP address.

Setting for core.machinekey

Parameter	Description
`-mk, --machinekey`	Setting for the core.machinekey key

This parameter allows you to specify your own machinekey when installing ONLYOFFICE DocSpace Developer.

This parameter is written to the /app/onlyoffice/config/appsettings.json configuration file (the path is specified within the onlyoffice-studio container).

Example

bash docspace-developer-install.sh -mk yourmachinekey

ONLYOFFICE DocSpace external port

Parameter	Description	Default
`-ep, --externalport`	ONLYOFFICE DocSpace external port	`80`

This parameter allows you to change the port on which ONLYOFFICE DocSpace will run. By default, port 80 is used.

Example

bash docspace-developer-install.sh -ep 8080

Settings for JWT header and secret

Parameter	Description
`-jh, --jwtheader`	Setting for the JWT header
`-js, --jwtsecret`	Setting for the JWT secret key

These parameters allow you you to specify the JWT header and your own JWT secret key when installing ONLYOFFICE DocSpace Developer. The JWT header defines the http header that will be used to send the JWT. The secret key is used to sign the JSON web token and validate the token upon the request to ONLYOFFICE Docs.

These parameters are written to the following configuration files (the paths are specified within the onlyoffice-studio and onlyoffice-document-server containers):

For DocSpace - /app/onlyoffice/config/appsettings.json
For Document Server - /etc/onlyoffice/documentserver/local.json

Example

bash docspace-developer-install.sh -js yoursecret

MySQL server

Parameter	Description	Default
`-mysqlrp, --mysqlrootpassword`	MySQL server root password	`my-secret-pw`
`-mysqlh, --mysqlhost`	MySQL server host	`localhost`
`-mysqlport, --mysqlport`	MySQL server port number	`3306`

If you do not explicitly specify these parameters, the default values are used.

Example

bash docspace-developer-install.sh -mysqlrp new-secret-pw

This command allows you to set your own password for the MySQL root account during the ONLYOFFICE DocSpace Developer installation.

ONLYOFFICE DocSpace database

Parameter	Description	Default
`-mysqld, --mysqldatabase`	ONLYOFFICE DocSpace database name	`onlyoffice`
`-mysqlu, --mysqluser`	ONLYOFFICE DocSpace database user	`onlyoffice_user`
`-mysqlp, --mysqlpassword`	ONLYOFFICE DocSpace database password	`onlyoffice_pass`

These parameters allow you you to create the ONLYOFFICE DocSpace database specifying custom database name, as well as a username and password for the account with superuser permissions on the created database. If you do not explicitly specify these parameters, the default values are used.

Example

bash docspace-developer-install.sh -mysqld docspacedatabase -mysqlu username -mysqlp password

Switching to HTTPS

Parameter	Description
`-led, --letsencryptdomain`	defines the domain for the Let's Encrypt certificate
`-lem, --letsencryptmail`	defines the domain administrator mail address for the Let's Encrypt certificate
`-cf, --certfile`	path to the certificate file for the domain
`-ckf, --certkeyfile`	path to the private key file for the certificate

These parameters allow you to switch the portal to HTTPS. They can be used for the Docker version only.

Example

bash docspace-developer-install.sh docker --letsencryptmail user@example.com --letsencryptdomain yourdomain.com

This will automatically create and install the letsencrypt.org CA-signed certificate to your server and restart the NGINX service for the changes to take effect.

bash docspace-developer-install.sh docker --certfile path --certkeyfile path

This will apply your own SSL certificate.

Host ONLYOFFICE DocSpace on your own server or use it in the cloud

Get it now Use in the cloud