Deploying ONLYOFFICE Workspace Community in DigitalOcean

Introduction

Now you can easily deploy the Docker version of the ONLYOFFICE Workspace in the DigitalOcean cloud infrastructure using a one-click app provided in the DigitalOcean Marketplace.

The one-click app is an image that includes all the necessary pre-configured components to deploy your web office on a DigitalOcean server running under Ubuntu OS:

• Docker service,
• MySQL Server,
• ONLYOFFICE Document Server,
• ONLYOFFICE Community Server,
• ONLYOFFICE Control Panel.

Step 1. Create your droplet in DigitalOcean

Log in to your DigitalOcean account and go to the DigitalOcean Marketplace.

Find the ONLYOFFICE Workspace application in the Business Apps category, move the mouse button over the app and click the ‘Create Droplet’ button that appears. Alternatively, you can open the droplet details page and click the ‘Create ONLYOFFICE Workspace Droplet’ button.

In the Choose a plan section, select the plan you want to use or leave the default one. The choice depends on the amount of memory that you need to store your portal data (documents, email messages, and so on). The default value of 8 GB is sufficient for running a web office.

Optionally, you may set up some other droplet parameters.

• Add block storage if necessary. Block storage allows you to add independent storage volumes that can be moved from one droplet to another within the same region.
• Change the datacenter region, if necessary. It’s recommended to select a region with the closest location.
• By default, your droplet will be available via the public IP address. If you choose a VPC network, the droplet will be able to communicate over a Private IP address only with other resources in the same VPC network. It will be inaccessible from the public internet.
• Check some additional options, if necessary: enable IPv6 networking, provide user data, or enable the droplet monitoring.

In the Authentication section, select the authentication type that will be used to access your droplet. You can either specify a root password or add an SSH public key.

Create a root password to access the droplet (password authentication is a less secure way than using SSH keys). The password must correspond to the following requirements:

• At least 8 characters long
• Must contain at least 1 uppercase character (first and last characters don’t count)
• Must contain at least 1 number
• Cannot end in a number or special character

Keep your password in a safe place. You will not receive any email messages containing your droplet details and password.

Using SSH keys is a more secure way to access your created droplet than using a password. In this case, the password authentication will be disabled by default. If you want to connect to your server using an SSH key instead of a password, add a new SSH public key or use a previously added one. A private key must be stored on your local machine. To learn more how to create SSH key pairs and add the public key to a droplet, you can refer to the DigitalOcean documentation.

• If necessary, you can change the number of created droplets, change a default hostname that will be used to identify the droplet within the DigitalOcean Control Panel, add tags, or choose a project to assign the droplet to, if you have multiple projects.
• Enable your droplet backups if you want to perform automatic backups of the droplet every week. Backups cost 20% of the droplet price.

Click the ‘Create Droplet’ button and wait while the droplet is being created. The newly created droplet will be displayed in the DigitalOcean Control Panel.

The server IP is displayed next to the droplet hostname. If you move the mouse button over the IP address, the Copy option appears. Click it to copy the IP address.

Step 2. Connect to your server via SSH to complete the installation

On Windows, you can use the PuTTY utility.

Enter the droplet IP address, make sure that port 22 is specified and the SSH connection type is selected.

If you added an SSH public key when creating the droplet, specify the path to your corresponding private key stored on your local machine in the Connection -> SSH -> Auth section.

Click the Open button. Then click Yes in the PuTTY Security Alert window.

• If you selected the password authentication when creating the droplet, use root as a login and enter your root password specified during the droplet creation.
• If you added an SSH key, you will be authenticated using your private key.

On Linux, you can use an SSH client like OpenSSH. Enter ssh root@your_droplet_ip to your terminal and type yes to continue connecting to the server.

• If you haven't added SSH keys, you'll be prompted for your password specified during the droplet creation.
• If you have multiple SSH keys, you may need to specify the path to your private key: ssh -i /path/to/private/key root@your_droplet_ip You will be authenticated using your private key.

Wait while the installation process is completed. During this process, the 6 GB of swap space will be allocated, the Docker onlyoffice-network will be created, and the onlyoffice-mysql-server, onlyoffice-document-server, onlyoffice-community-server, and onlyoffice-control-panel Docker containers will be started automatically.

Step 3. Access your portal via a web browser

In a web browser, enter http:// + your droplet IP address into the address bar. The initialization of your portal may take a few minutes.

The portal setup wizard opens. Set your account password and confirm it. By default, the password must be at least 8 but no more than 120 characters long. Enter your email address.

These email and password will be used to access your portal administrator account via a web browser.

You can also change the portal language and time zone using the corresponding drop-down lists. The time zone must be specified to ensure the correct work of the portal notifications and calendar reminders.

Accept the terms of the license agreement by checking the corresponding box and clicking the ‘Continue’ button.

Your portal is now created and ready to work. Switch between the portal modules available on the start page to explore the web office features.