Deploy ONLYOFFICE Workspace Community on Ubuntu 24.04

For a straightforward Ubuntu 24.04 deployment, use ONLYOFFICE’s official Workspace Community installer with Docker and omit the Mail component unless you have a domain and plan to run email. Before you begin, check the server resources and free ports: ONLYOFFICE lists at least 8 GB RAM, 40 GB free disk space, and a 4-core CPU as minimums for this resource-intensive setup.

Should you use the Community installer?

ONLYOFFICE Workspace combines document editing with collaboration tools. The Community edition is the free option. Its official Linux installer can install Docs, Community Server, Control Panel, and Talk; the Mail Server can be added separately. This procedure uses the vendor’s Docker-based script on an amd64 Ubuntu server. ONLYOFFICE’s current requirements describe compatible 64-bit Linux distributions rather than explicitly naming Ubuntu 24.04, so confirm compatibility for your own deployment and check the current vendor documentation before production use.

Do not choose this setup for a small virtual machine that falls below the published minimums. ONLYOFFICE lists 4 CPU cores, 8 GB RAM, and 40 GB of free disk space as minimums, with 6 cores and 12 GB RAM recommended. The installer creates a 6 GB swap file automatically. Allow extra disk capacity for uploaded files, logs, backups, and future growth; 40 GB is the listed minimum, not a sizing recommendation for a busy team.

What should you prepare first?

  • A fresh or appropriately prepared 64-bit Ubuntu 24.04 server with administrator access.
  • Docker available on the server. The installer checks for Docker and can install or update it.
  • At least 4 CPU cores, 8 GB RAM, and 40 GB free space, plus the installer-managed swap.
  • Network access to download the installer and container images.
  • Unoccupied ports required by the components you intend to install. The vendor’s port list should guide firewall rules.

If another web server or application already uses a required port, stop and plan the port or reverse-proxy arrangement before installing. Do not terminate an existing service blindly. For a public server, prepare a domain name and HTTPS plan before inviting users or exposing the portal to the internet.

How do you install Workspace without Mail?

1. Download the official installer

Connect to the Ubuntu server over SSH, then download the script from ONLYOFFICE’s documented download host:

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

Before running a privileged installer, confirm that the file arrived and inspect its opening lines:

ls -lh workspace-install.sh
less workspace-install.sh

Press q to leave the viewer. The vendor’s installation guide is the source for this script and its parameters; use that page to review any changes before repeating the procedure later.

2. Run the Community installation

Start the installer with administrator privileges and the documented option to skip Mail:

sudo bash workspace-install.sh -ims false

The -ims false parameter tells the installer not to install ONLYOFFICE Mail. The script installs and configures the Workspace components using Docker, and may install or update Docker when necessary. Follow any prompts shown by the script. Keep the SSH session open while installation is running and avoid interrupting package or container setup.

If you do want Mail, do not simply remove the parameter and assume email will work automatically. The vendor’s Mail instructions require a valid domain configured for the machine, including appropriate DNS records. Mail also adds services and network ports that you may not need for document collaboration.

How do you open the new Workspace?

When the installer finishes, open a browser on a computer that can reach the server and enter the server’s LAN IP address, such as http://192.168.1.20. Replace that example with the actual address. ONLYOFFICE specifically advises using the machine’s network IP rather than localhost or 127.0.0.1 when checking the installation. Complete the first-run screen presented by your installation and create an administrator account; do not rely on a default password unless the official instructions for your exact version explicitly provide one.

For a remote or internet-facing deployment, configure a DNS name and HTTPS before normal use. The installer’s local-IP check confirms that the service responds on the network; it does not by itself establish secure public access. Follow the official HTTPS procedure for the installation type you chose, and permit only the ports needed for the selected Workspace modules.

What if installation fails?

  • A required port is busy: identify which service owns the port and decide whether to reconfigure that service or change the deployment plan. ONLYOFFICE recommends verifying required ports are free; do not kill an unfamiliar process.
  • The installer cannot download images: confirm DNS, outbound internet access, and Docker status. If the host intentionally has no internet access, the vendor documents configuring Docker to use a reachable local DNS resolver.
  • The browser cannot reach the portal: verify the server’s LAN address, host firewall, and whether the install completed. Test from a machine on the same network before troubleshooting external access.
  • The server is slow or runs out of memory: compare its resources with the vendor’s minimum and recommended figures. Adding RAM or CPU may be necessary; a restart will not compensate for an undersized host.

How can you verify the deployment?

Confirm that the installer completed without a fatal error, the portal opens from another device using the server’s LAN IP, and you can finish the initial administrator setup. Then review the firewall and HTTPS configuration before adding users or sharing files. Keep a separate backup plan for Workspace data; a running Docker container is not a backup.

Official documentation

Leave a Comment

Deploy ONLYOFFICE Workspace Community on Ubuntu 24.04

Deploy ONLYOFFICE Workspace Community on Ubuntu 24.04

Install ONLYOFFICE Workspace Community on Ubuntu 24.04 with the official Docker script, check server requirements, skip Mail if needed, and verify the portal safely.

Set Up ONLYOFFICE JWT Secrets Across Server and Connector

Set Up ONLYOFFICE JWT Secrets Across Server and Connector

Configure matching JWT secrets for ONLYOFFICE Docs and its connector, with safe steps for Linux packages, Docker deployments, and verification.

Put ONLYOFFICE Docs Behind HAProxy Without Breaking Editing

Put ONLYOFFICE Docs Behind HAProxy Without Breaking Editing

Configure HAProxy HTTPS, forwarding headers, WebSocket timeouts, and health checks for ONLYOFFICE Docs, then verify editing and saves.

Brand ONLYOFFICE Docs with Your Logo and Theme Colors

Brand ONLYOFFICE Docs with Your Logo and Theme Colors

Give an embedded ONLYOFFICE Docs editor your company logo and interface colors with a custom theme file and editor configuration. See edition limits and deployment checks.

Keep Writer Revisions Visible When Exporting to DOCX

Keep Writer Revisions Visible When Exporting to DOCX

Track edits in Writer, preserve an editable ODT source, and check the exported DOCX in Word before sharing it.

Enable FIPS Mode on SLES 15 and Verify the Boot State

Enable FIPS Mode on SLES 15 and Verify the Boot State

Follow SUSE’s SP7 procedure to enable FIPS mode, reboot safely, verify the active policy, and check whether your compliance requirement calls for validated modules.

Set Up a LUKS-Encrypted Data Volume on SLES

Set Up a LUKS-Encrypted Data Volume on SLES

Compare YaST and cryptsetup for a new encrypted SLES data volume, choose LUKS1 or LUKS2, and verify unlock and mount behavior safely.

Build a Custom AppArmor Profile on SUSE Linux

Build a Custom AppArmor Profile on SUSE Linux

Create, refine, and verify a least-privilege AppArmor profile on SLES 15 SP7, with a clear note on SLES 16’s SELinux default.

Build a Local SUSE Update Server with RMT on SLES 15

Build a Local SUSE Update Server with RMT on SLES 15

Set up RMT on SLES 15, mirror entitled repositories, and verify HTTPS registration and package access from a test client.

Join SLES 15 to Active Directory with SSSD in YaST

Join SLES 15 to Active Directory with SSSD in YaST

Connect SLES 15 to AD with YaST’s SSSD-based logon management, then verify directory lookup, domain login, and Kerberos tickets.