ONLYOFFICE Workspace - OneClickInstall

A simple self-hosted installer for ONLYOFFICE Workspace using Docker or Linux packages.

| 🚀 Start | 🛠 Flags | 💡 Examples | 🖥️ Reqs | ✅ OS | 📚 Resources | 📝 License | |--------------------------|--------------------------------------------|---------------------------|----------------------------------------|----------------------------------------|----------------------------------------|----------------------|

ONLYOFFICE Workspace is a bundle of web apps for team management and collaboration, including:

• 📝 Docs - powerful collaborative editors
• 📧 Mail - secure mail server
• 📊 CRM - customer relationship management
• 📁 Projects - tasks and milestones tracking
• 📅 Calendar - event scheduling and reminders

Supports all popular office formats: DOCX, XLSX, PPTX, ODT, PDF, CSV, TXT, HTML, EPUB,
and combines them with collaboration tools for tasks, projects, and team communication - all in one secure platform.

🚀 Quick Start

1. Download the installer

Community Edition (default):

curl -O https://download.onlyoffice.com/install/workspace-install.sh

If you want to install a different edition, choose one of the following:

Enterprise Edition

curl -O https://download.onlyoffice.com/install/workspace-enterprise-install.sh

Groups (Community Server only)

curl -O https://download.onlyoffice.com/install/groups-install.sh

2. Run the script

The script detects your OS and installs ONLYOFFICE Workspace using Docker (or native packages, if selected).

sudo bash workspace-install.sh

Enterprise Edition

sudo bash workspace-enterprise-install.sh

Groups

sudo bash groups-install.sh

You'll be prompted to choose the installation method:

• Y — Docker install (recommended)
• N — native .deb / .rpm packages

🛠 Flags

All scripts support --help to show available flags. View available options with:

sudo bash workspace-install.sh --help

Common flags

Works for both Docker and package installations

| Flag | Value placeholder | Default value | Description | |-----------------------|-----------------------------------------------|--------------------------|--------------| | --installationtype | GROUPS|WORKSPACE|WORKSPACE_ENTERPRISE | WORKSPACE_ENTERPRISE | Edition | | --update | true | false | false | Update | | --skiphardwarecheck | true | false | false | Skip checks |

Docker flags

Applies only to Docker installation

| Flag | Value placeholder | Default value | Description | |----------------------------|------------------------------|--------------------------------|-------------------------| | --communityimage | <NAME> | <.tar.gz> | onlyoffice/communityserver | CS image | | --documentimage | <NAME> | <.tar.gz> | onlyoffice/documentserver-ee | Docs image | | --mailimage | <NAME> | <.tar.gz> | onlyoffice/mailserver | Mail image | | --elasticsearchimage | <NAME> | <.tar.gz> | onlyoffice/elasticsearch | ES image | | --controlpanelimage | <NAME> | <.tar.gz> | onlyoffice/controlpanel | CP image | | --mysqlimage | <NAME> | <.tar.gz> | mysql | MySQL image | | --communityversion | <VERSION> | (latest stable) | CS version | | --documentversion | <VERSION> | (latest stable) | Docs version | | --mailversion | <VERSION> | (latest stable) | Mail version | | --elasticsearchversion | <VERSION> | 7.16.3 | ES version | | --controlpanelversion | <VERSION> | (latest stable) | CP version | | --documentserverip | <IP> | - | Docs IP | | --elasticsearchhost | <HOST> | - | ES host | | --elasticsearchport | <PORT> | 9200 | ES port | | --mailserverip | <IP> | - | Mail IP | | --mailserverdbip | <IP> | - | Mail DB IP | | --hub | <DOMAIN> | - | DockerHub domain | | --username | <USER> | - | DockerHub user | | --password | <PASS> | - | DockerHub password | | --installcs | true | false | pull | true | Install/skip/pull CS | | --installdocs | true | false | pull | true | Install/skip/pull DS | | --installmailserver | true | false | pull | true | Install/skip/pull Mail | | --installelasticsearch | true | false | pull | true | Install/skip/pull ES | | --installcontrolpanel | true | false | pull | true | Install/skip/pull CP | | --useasexternalserver | true | false | false | Expose services | | --partnerdatafile | <FILE> | - | Partner data path | | --makeswap | true | false | true | Create swap file | | --communityport | <PORT> | 80 | HTTP port for CS | | --mysqlhost | <HOST> | - | MySQL host | | --mysqlport | <PORT> | 3306 | MySQL port | | --mysqlrootuser | <USER> | root | MySQL root user | | --mysqlrootpassword | <PASSWORD> | my-secret-pw | MySQL root password | | --mysqldatabase | <DB> | onlyoffice | CS database name | | --mysqluser | <USER> | onlyoffice_user | CS database user | | --mysqlpassword | <PASSWORD> | onlyoffice_pass | CS user password | | --mysqlmaildatabase | <DB> | onlyoffice_mailserver | Mail DB name | | --mysqlmailuser | <USER> | mail_admin | Mail DB user | | --mysqlmailpassword | <PASSWORD> | Isadmin123 | Mail DB password | | --skipversioncheck | true | false | false | Skip version check | | --skipdomaincheck | true | false | false | Skip domain check | | --machinekey | <KEY> | (auto-generate) | machinekey setting | | --jwtenabled | true | false | true | Enable JWT | | --jwtheader | <HEADER> | AuthorizationJwt | JWT header | | --jwtsecret | <SECRET> | (auto-generate) | JWT secret key |

Package-specific flags

Applies only to package installation

| Flag | Value placeholder | Default value | Description | |------------------|-------------------|----------------|-------------------| | --localscripts | true | false | false | Run local scripts |

💡 Examples

Typical usage scenarios with different combinations of flags.

1. Quick install on port 8080

sudo bash workspace-install.sh --communityport 8080

2. Update all components, skip hardware check

sudo bash workspace-install.sh \
  --update true \
  --skiphardwarecheck true

3. Install without Mail Server

sudo bash workspace-install.sh --installmailserver false

4. Document Server only (external)

sudo bash workspace-install.sh \
  --installcs false \
  --installdocs true \
  --installcontrolpan