Deploying ONLYOFFICE Docs in DigitalOcean

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

Find ONLYOFFICE Docs 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 Docs Droplet’ button.

In the Choose a plan section, select the plan you want to use or leave the default one. The Basic plan that provides 8 GB RAM and 4 CPUs is sufficient for running ONLYOFFICE Docs.

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 a 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 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. 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 on a weekly basis. 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.

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 onlyoffice-document-server Docker container will be started automatically.

To explore the solution functionality, enable our test example which will allow you to upload your local files for testing. To do that, execute the following command:

sudo docker exec $(sudo docker ps -q) sudo supervisorctl start ds:example

Add the example to the autostart:

sudo docker exec $(sudo docker ps -q) sudo sed 's,autostart=false,autostart=true,' -i /etc/supervisor/conf.d/ds-example.conf

Once the example is started, enter http:// + <your droplet IP address>/example/ into a web browser address bar.

The ONLYOFFICE Docs example page opens. Here you can:

1. Upload a file stored on your PC using the Upload file option.
2. Create a new blank text document, spreadsheet, presentation, or form template using the Create new -> Document, Spreadsheet, Presentation, or Form template options. If you want to create a file with a sample content, first check the With sample content box.

The uploaded or created file will open in a new browser tab with the corresponding ONLYOFFICE Online Editor so that you can test editing capabilities.

The file will also appear in the Your documents list at the ONLYOFFICE Docs example page.

If you want to check co-editing capabilities, select another test user from the Username list and then click on the same document in the Your documents list to open it in a new browser tab.

To easily integrate ONLYOFFICE Docs with one of the business platforms like Alfresco, Confluence, Liferay, Nextcloud, ownCloud, SharePoint, HumHub etc., you can use integration connectors for these solutions as it is described here: https://api.onlyoffice.com/editors/plugins Use the droplet IP address to specify the ONLYOFFICE Docs address in your web application settings, e.g. http://<your droplet IP address>/

To integrate ONLYOFFICE Docs with your own web application, you can refer to the API Documentation https://api.onlyoffice.com/editors/basic