How to Deploy OnlyOffice – An Opensource Office Suite
OnlyOffice is an open-source office suite that enables word processing, spreadsheets, presentations, forms, and portable document format file creation tools on a server. OnlyOffice offers collaboration tools such as external user invitations and integrates with team collaboration applications such as Zoom to improve file sharing and management during meetings.
OnlyOffice is available in multiple editions such as OnlyOffice DocSpace, Docs, Groups, and Workspace. This guide explains how to deploy OnlyOffice DocSpace using Docker on a production Ubuntu server. You will enable the OnlyOffice server to integrate and support external service applications such as desktop editors, WordPress, Mattermost, and NextCloud to enable document creation functionality.
Prerequisites
Before you begin, you need to:
- Deploy a One-Click Docker instance using the Vultr marketplace application with at least
8 GBRAM. - Create a new subdomain DNS record that points to the server IP address.
- Access the server using SSH as a non-root user with sudo privileges.
- Update the server.
- Create a Vultr Object Storage subscription and locate your S3 access credentials to back up OnlyOffice to Vultr Object Storage.
Install OnlyOffice
You can install OnlyOffice as a standalone package for your server distribution or a Docker image that runs on your server with all required environment packages. Follow the steps below to install OnlyOffice using Docker to run with all necessary dependencies on your server to ensure improved performance and document creation.
Download the latest OnlyOffice installation script.
CONSOLERun the OnlyOffice installation script using Bash.
CONSOLEEnter Y to accept the Install with Docker installation option, then press Enter to pull and deploy the OnlyOffice Docker image on your server.
If you receive a domain error, enter Y to accept your server hostname and install OnlyOffice.
When the process is complete, your output should be similar to the one below.
View the list of Docker processes and verify that all OnlyOffice containers are active and healthy.
CONSOLEYour output should be similar to the one below.
List files in the
/app/onlyoffice/directory to verify that all OnlyOffice host files are available on your server.CONSOLEOutput:
The above directory files allow you to manage or modify the OnlyOffice installation on your server. The
configdirectory contains executable scripts and log files you can use for multiple tasks such as generating SSL certificates on your server.
Generate OnlyOffice Let's Encrypt SSL Certificates
OnlyOffice runs and listens for connection requests on the host HTTP port 80 on your server. Configure OnlyOffice with your domain name and generate SSL certificates to encrypt all connections to the server and enable HTTPS connections on the host port 443. Follow the steps below to enable firewall rules and secure the OnlyOffice server with SSL certificates.
View the Uncomplicated Firewall (UFW) status and verify that the firewall application is active on your server.
CONSOLEOutput:
Allow connections to the OnlyOffice HTTP port
80.CONSOLEAllow the HTTPS port
443.CONSOLEReload UFW to apply the configuration changes.
CONSOLENavigate to the OnlyOffice configuration files directory
/app/onlyoffice/config.CONSOLERun the OnlyOffice Let’s Encrypt SSL script
docspace-ssl-setupand generate new trusted certificates using your domain. Replaceonlyoffice.example.comandonlyoffice@example.comwith your actual details.CONSOLEWhen successful, your output should be similar to the one below.
List the directory files and verify that a new
docspace-renew-letsencryptfile is available.CONSOLEOutput:
You have generated Let's Encrypt SSL certificates to secure the OnlyOffice server. The
docspace-renew-letsencryptfile runs every 90 days to automatically renew the Let's Encrypt certificate before expiry.
Access OnlyOffice
Access your OnlyOffice domain using a web browser such as Chrome.
Verify that the OnlyOffice setup interface displays in your web browser.
Enter your administrative user email address in the Email field for use with OnlyOffice.
Enter a strong password in the Password field or click Generate password to create a new random password.
Select your language and click Timezone to set a new timezone to use with the OnlyOffice server.
Accept the OnlyOffice license terms.
Click Continue to create the new administrative user and redirect to the main OnlyOffice dashboard.
Verify that the OnlyOffice interface displays correctly in your web browser to set up new rooms.
Click the + symbol next to Rooms to create a new OnlyOffice room.
Select your desired OnlyOffice room type depending on the privacy and access type. OnlyOffice supports the following rooms with different user privileges:
- Collaboration room: Enables multiple user access and document collaboration on your server.
- Custom room: Enables customization options and user access permissions on the server. Available user privileges include Editor, Power user, Room admin, Reviewer, Viewer, and Commenter.
- Public room: Enables public access to your OnlyOffice servers and enables users to access files using external links.
For example, click Public room to set up a new public room that allows external users to access shared documents on your server.
Enter your new OnlyOffice room in the Name field.
Enter a new tag, click Create tag, and upload a new image to customize your new public room information.
Click Create to apply the new OnlyOffice room on your server.
Click + next to the room name and select a new document type to create on your server. For example, New document to set up a word document.
Enter your new document name and click Create to open the new OnlyOffice document.
Verify that the new document loads in your web browser and enter sample text to test write privileges on the file.
Click File on the main navigation menu.
Select Save to apply the file changes and save the new document on your server.
Integrate OnlyOffice with External Applications
OnlyOffice is compatible with most team collaboration applications such as Zoom, Mattermost, NextCloud, and ownCloud using connector plugins. Some applications may be incompatible with DocSpace and require a standalone Docs document server installation. Follow the sections below to integrate and connect external services to your OnlyOffice DocSpace server.
Back Up OnlyOffice to Vultr Object Storage
Access the OnlyOffice web interface.
Click options next to the Administrator user card and select Settings from the list of options.
Click Integration on the settings navigation menu to install new plugins.
Within the Third-party services, scroll and click the AWS activation button to access the configuration page.
Enter your Vultr Object Storage credentials in the S3 accesskey and S3 secret access key fields respectively.
Click Enable to apply your credentials and activate Vultr Object Storage as the active S3 storage service on your server.
Navigate to Backup on the main navigation list.
Click Third-party storage in the Data backup section to back up OnlyOffice to Vultr Object Storage.
Select Amazon AWS S3 from the list of storage options and enter your Vultr Object Storage bucket in the Bucket field.
Click the region drop-down and select the closest location to your Vultr Object Storage region.
Enter your Vultr Object Storage hostname URL in the Service URL field.
Click Create Copy to create your first OnlyOffice backup copy.
Verify that the OnlyOffice backup is successful. The dashboard displays a popup message that reads, "The backup copy has been successfully created."
Access your Vultr Object Storage bucket and verify that the new OnlyOffice backup objects are available.
Connect the OnlyOffice Desktop Application to OnlyOffice DocSpace
Download and install the latest OnlyOffice desktop editors application on your device.
Open OnlyOffice from your main applications menu to access the new application interface.
Click Connect to cloud with the OnlyOffice interface.
Click Connect now below the Create an ONLYOFFICE cloud button to set up a new connection to your DocSpace server.
Enter your OnlyOffice server URL in the Cloud office URL field. For example,
https://onlyoffice.example.com.Enter your OnlyOffice user email address and password respectively to authenticate with the server.
Click Sign in to validate the user details and connect to your OnlyOffice document server.
Open your OnlyOffice rooms to view and create new documents on your server using the desktop application.
Conclusion
You have deployed OnlyOffice on your server and configured the application to integrate with external services to enable document creation. OnlyOffice rooms enable team collaboration to create, edit, and manage multiple files on your server. OnlyOffice integrates with storage platforms such as Vultr Object Storage to back up and process multiple files with efficient storage on your server.
0 Comments
Be the first to comment and share your perspective with the community.