Articles with the tag:
Help Center
Community Edition virtual machine image

Running Community Edition virtual machine image using Microsoft Hyper-V


Community Edition is a paidfree version free for educational institutions of collaborative system developed to manage documents, projects, customer relationship and email correspondence, all in one place.

Community Edition is shipped as a virtual machine image, compatible with most popular virtual machine managing software. Running virtual machine image is easy and does not require any additional setup as the image has already been configured and thoroughly tested, excluding errors which might occur during the installation and configuration process.

This guide will show you how to run Community Edition virtual machine image with Microsoft Hyper-V server virtualization software.

System requirements

  • CPU
    dual core 2 GHz or better
  • RAM
    6 GB or more
  • HDD
    at least 40 GB of free space
  • Additional Requirements
    • Microsoft Hyper-V: version 6.1 or later

Microsoft Hyper-V is included into Windows Server 2012, but it might be not enabled. See the official Microsoft manual on how to do that.

Getting Community Edition image

First you need to download Community Edition image file. You can do that using our site download pagedownload page. Once the download is finished, unpack the image file to the location on your computer or server where it will be stored and accessed by Hyper-V software.

Create new virtual machine

Now go to Control Panel, choose Administrative Tools and run Hyper-V Manager. In Hyper-V Manager click New in the right side menu, the wizard window will be opened where you will be able to set the following:

  1. Specify Name and Location tab: enter the name for your virtual machine in the Name field (e.g. Community Edition). By default all the machine data will be saved to the system hard disk drive, you can change that using the Store the virtual machine in a different location option and choosing the new location for your machine data. Click Next when done.
  2. Assign Memory tab: specify the amount of Memory used for the virtual machine, at least 4 GB although 6 GB is the recommended value. Click Next when done.
  3. Configure Networking tab: use the Connection list to select a network adapter to use. Each new virtual machine includes a network adapter, and you can configure the adapter to use an available virtual network for communicating with other computers. See the steps below to learn how to properly configure the adapter settings for the Community Edition virtual machine to be accessible from outside. Click Next when done.
  4. Connect Virtual Hard Disk tab: select the Use an existing virtual hard disk option, click Browse, and then use the Open dialog box to select the downloaded and unpacked image file to use. Click Next when done.
  5. Summary tab: review all the previous steps to finish the installation process or return to some of them and correct the selected settings.

After that click Finish.

Running Community Edition for the first time

To run Community Edition virtual machine in Hyper-V Manager, right-click the name of the virtual machine, and then click Connect. In the Virtual Machine Connection window, click Start. The machine will be started and will load like a common Ubuntu Linux operating system.

The first time run will ask you for the Ubuntu Linux operating system access credentials. The following ones are used:

  1. login: onlyoffice
  2. password: onlyoffice

You will be asked to change the password at the first login. After the successful login all the services necessary for Community Edition start will be automatically launched. You can check if everything is okay launching an available browser and entering the local network machine IP address (please do not use either localhost or network address for the same machine where you have Community Edition installed, use its IP address in the local network instead) to the browser address bar. The Community Edition welcome screen will be displayed which will mean that everything is up and running.

Making Community Edition available from outside

To make Community Edition available from outside (including other computers over the network or via the Internet), you need to properly set up the virtual machine adapter. To do that:

  1. Go to Hyper-V Manager and choose Virtual Network Manager in the right-hand window under Actions.
  2. Make sure that External is highlighted under What type of virtual network do you want to create? and click Add.
  3. On the New Virtual Network screen, type the new adapter name in the Name field (you can choose any you like as long as you will be able to distinguish it from other adapter names). In the Connection Type section, make sure the External radio button is selected and then choose your physical server network adapter. Click OK.
  4. A warning box may appear stating that you are going to temporary lose your network connection while the virtual adapter is being configured. Click Yes and close Hyper-V Manager after that.

Once this is done, start the virtual machine, login and go to Ubuntu network settings and set the necessary parameters for your server to be connected either to the local network or to be accessible via the Internet. See our article or Ubuntu official documentation for more information on how this can be done.

Docker (used to run Community Edition in the virtual machine image) specifies Google DNS servers by default. If your Community Edition server is not going to have access to the Internet, we recommend that you change the default Docker DNS address to the address of your local DNS server. To do that go to the /etc/default/docker file and change the IP address in the following line to the IP address of a DNS server in your local network:
How to run virtual machine image using Microsoft Hyper-V on Windows 10
Download Host on your own server Available for Docker,
Windows, Linux and virtual machines
You Might Also Like This: