General issues
Q:I want to install the server solution onto my local server. Where can I download the latest version?
A:The latest server solution is available at Github and SourceForge.
Q:I opened the server solution folder at SourceForge/Github and found several files/subfolders there. What is the difference between them?
A:At SourceForge, you can find the ONLYOFFICE Groups installation file and source codes:
- The ONLYOFFICE_CommunityServer_Win-install.(version_number).exe installation file allows you to skip compilation stage and install ONLYOFFICE Groups onto your server. You just need to run the .exe file and the server solution will be installed. Please refer to our detailed guide to learn more on the installation process.
- The sources folder contains the ONLYOFFICE Groups source code that you need to compile. It can be customized and improved under the GNU AGPL v.3 license. Please refer to these instructions to find out how to compile and deploy the server solution from source codes.
The CommunityServer folder at Github contains the ONLYOFFICE Groups source codes.
Q:After I create and enter the portal, I can see an unknown user in the People module with the 'fake user' name. There is also some OnlyofficeHealthCheck service in the services list. Why is this and do I need to do something about it?
A:The user and the service are a part of the upcoming Health Check functionality which will be available for the portals in the future releases. As for now it is not functional, so you can either leave it as is or disable the OnlyofficeHealthCheck service and remove it from the service automatic startup list.
Q:What system do I need to have to install the server solution and successfully use it?
A:The system requirements are:
-
CPU
dual core 2 GHz or better
-
RAM
at least 2 GB, but depends of the host OS. More is better
-
HDD
at least 20 GB of free space
-
OS
Microsoft Windows Server 2016 or later
Q:I have already installed the server solution onto my server, but I'm not sure what version I use. How can I check this?
A:You can check the exact version number in the following way:
- open the
web.studio/web.appsettings.config
file
- have a look at the <add key=”web.install-url” value=”http://service.onlyoffice.com/install/email.ashx?v=77″ /> parameter, namely what number goes after v=
Q:I installed Community Server together with Control Panel and Docs, then uninstalled Docs and now Control Panel does not work.
A:You need to reset the connection paths to Docs and restart Community Server in IIS. Perform the following steps:
- Go to the
C:\Program Files (x86)\Ascensio System SIA\CommunityServer\WebStudio\
folder and open the web.appsettings.config
file with a text editor.
Clear the values of the following keys and save the changes.
<add key="files.docservice.url.public" value="" />
<add key="files.docservice.url.internal" value="" />
<add key="files.docservice.url.portal" value="" />
- Reset the editor connection settings in the portal settings:
Go to the http://127.0.0.1/Management.aspx?type=17
page and press the Reset button.
- Restart the ONLYOFFICE Server website in IIS:
Go to Start -> Windows Administrative Tools and run the Internet Information Services (IIS) Manager. In the IIS Manager, drop-down the Sites section on the Connections panel. Right-click on the ONLYOFFICE Server
website in the list and select the Manage Website -> Restart option.
Installation issues
Q:I need installation instructions. Where can I find them?
A:The installation instructions can be found in the Installing section of our Help Center.
Q:I'd like to install the server solution onto Windows Server 2012. Is it possible?
A:Yes, you can install the server solution onto Windows Server 2012, but you’ll need to make some alterations in its settings to get the server solution run:
- go to
C:\Windows\System32\inetsrv\config\applicationHost.config
- find the <sectionGroup name=”system.webServer”> section
- change <section name=”handlers” overrideModeDefault=”Deny” /> to <section name=”handlers” overrideModeDefault=”Allow” />
- change <section name=”modules” overrideModeDefault=”Deny” /> to <section name=”modules” overrideModeDefault=”Allow” />
Q:I use an older server solution. How can I migrate to the latest one?
A:The detailed instructions on how to upgrade ONLYOFFICE Groups to the latest version can be found in this article.
Please don't forget to backup your portal data before you start the migration process.
Q:I get the following error: "Server Error in ‘/’ Application. Index was out of range. Must be non-negative and less than the size of the collection". How can I solve this problem?
A:Please try to add symbols to the core.machinekey
key in the web.appsettings.config
file, so that it contains 8 or more symbols.
Q:I get the following error: "{SQL_ERROR}: {SQL_STATE: HY000} Specified key was too long; max key length is 1000 bytes". How can I solve this problem?
A:We recommend that you install mysql-essential-5.1.58-win32 or you need to change the settings of your database server, so that it lets you use long keys.
Q:I have just installed the server solution onto my computer, but I can't find its folders. Could you tell me where I can find them?
A:By default, versions older than 7.5 are installed into the following directory: C:\ProgramData\TeamLab, version 7.5 is installed into the C:\Program Files (x86)\TeamLab Server directory, version 7.7 is installed into the C:\Program Files\Ascensio System SIA\ONLYOFFICE directory.
Q:I have downloaded the source code. But I don't know how to start using it with Visual Studio 2010. What am I doing wrong?
A:The server solution represents a number of small projects, not a single one that can be opened using Visual Studio. These projects are compiled using the following .bat file: redistributable\asc\BuildAndDeploy.bat
. We use Visual Studio 2012.
Configuration issues
Q:When I try to launch ONLYOFFICE Groups for the first time, the localhost is unavailable and the ONLYOFFICE website does not run returning the The process cannot access the file because it's being used by another process. (Exception from HRESULT: 0x80070020) error. How can this be fixed?
A:The error can be fixed in two ways:
- switch the ONLYOFFICE website to another port in Internet Information Services (IIS);
- or remove all other websites (if you have any) in IIS from port 80.
You can also try to disable Skype in case you have it running.
Q:I want to switch my portal from HTTP to HTTPS. How can I do that?
A:Place your certificate in PEM format on the computer where the server solution is installed. Specify the full path to this file using the slash (/) in the server solution config.js
file. Then restart the OnlyOfficeRouter
service.
Q:I want to change the domain name of my portal. How do I do that?
A:You can assign a domain name either in the DNS Settings - Custom domain name field on the Settings - General tab, or in the mappeddomain
field of the tenants_tenants
table.
Q:I cannot use full text search with ONLYOFFICE Groups. How can set it up?
A:To set up full text search in ONLYOFFICE Groups you will need to do the following:
- Download
sphinx
version 2.2.10 from the official website
- Unpack the downloaded archive file to some place, e.g. to
C:\Program Files\Sphinx-2.2.10
- Add path to the
bin
Sphinx directory (e.g. C:\Program Files\Sphinx-2.2.10\bin
to the system (NOT user) PATH environment variable.
This is done the following way: go to the Control Panel -> System -> Advanced system settings - in the opened dialog window click the Environment Variables... button, there choose the PATH variable and click Edit. Select New in the opened window, enter the name for the new varialbe (e.g. sphinx
), and browse for its path using the appropriate button. Then save the results.
- Change the OnlyofficeIndex launch type from
disabled
to automatic
and run it.
Go to the Control Panel -> Administrative Tools -> Services, find the OnlyofficeIndex service, right-click it and select Properties. In the opened dialog window use the drop-down menu to select the Automatic startup type, click OK and start the service.
Automatic installation is not supported for Windows due to licensing restrictions.
Q:I have a problem with the email notifications being sent. I get messages with the server name where the server solution is being hosted (PC name) instead of my custom DNS name which I added. How to solve it?
A:Please add the <add key=”web.host” value=”<YOUR_DOMAIN>”/> string into the web.appsettings.config
file.
Q:I added the domain to the web.appsettings.config file. It works if I run a website on port 80. How can I define that for a different port?
A:You can add the following string within the web.appsettings.config
file: <add key=”web.host” value=”http://<DOMAIN>:<PORT>”/>.
Q:I've successfully configured and tested the SMTP settings, but email notification is not working. Why is it so?
A:Obviously you have some problems with your network. Please try to check it. For this purpose please go to Start >> Run, enter the cmd command. Then enter ping notify.onlyoffice.com or ping mail.onlyoffice.org into the opened black window and press the Enter key. If after that your IP address isn’t displayed, something is wrong with your network.
Q:Talk does not work. How can I solve this problem?
A:Make sure that the OnlyofficeJabber
service is running and added to the firewall and antivirus exceptions. Ports 5222 and 5280 must be opened.
Q:Mailbox cannot be connected to the Mail module or no mail is received to the connected mailbox. How can I solve this problem?
A:Make sure that the OnlyofficeMailAggregator
service is running and added to the firewall and antivirus exceptions. Also, make sure that the following ports are opened for the outgoing requests:
SMTP
: 25, 465
IMAP
: 143, 993
POP3
: 110, 995
Q:Notifications about the portal events are not received to the email address. How can I solve this problem?
A:Make sure that the OnlyofficeNotify
service is running and added to the firewall and antivirus exceptions. Make sure that the port 25 is opened for the outgoing requests.
Q:OnlyofficeAutoreplay Service does not work. How can I solve this problem?
A:Make sure that the port 25 is opened for the incoming requests. Make also sure that you set your DNS MX record correctly.
Q:I want to update something in the code of the server solution to look like I want it to be. There should be a solution file to see a well arranged project. Where can I find that solution file?
A:There is no solution file, but you can create it yourself and add the projects to it manually. Projects compilation order can be found here: _ci\projects\build.proj
.
Usage issues
Q:I need to backup my portal data. How can I do that?
A:You can create a database backup by means of MySQL. Or you can create a data backup manually by copying your data from the following directories:
Data\Files\ |
Data\Mail\ |
web.studio\addons\mail\Data |
web.studio\data\ |
web.studio\Products\Community\Modules\Blogs\Data\ |
web.studio\Products\Community\Modules\Bookmarking\Data\ |
web.studio\Products\Community\Modules\Forum\Data\ |
web.studio\Products\Community\Modules\News\Data\ |
web.studio\Products\Community\Modules\PhotoManager\Data\ |
web.studio\Products\Community\Modules\Wiki\Data\ |
web.studio\Products\CRM\Data\ |
web.studio\Products\Projects\Data\ |
Q:I tried to access the portal from my Android phone, but I failed. Why?
A:The server solution doesn’t have the mobile access, so you can’t access your portal from Android phones and iOS devices that would be possible, if you’d use the SaaS solution.
Q:The Projects module is stuck at the loading icon after migrating from 6.0 to 6.5. How can I solve the problem?
A:First of all try to clear your browser cache – some Java scripts were updated in version 6.5 and if the scripts of the previous version were saved in cache, it may cause the problem.
Q:While using the server solution, I faced a problem that is not mentioned here. What should I do?
A:Feel free to visit our forum for developers to find answers to any questions you have. You can also describe your problem in Github Issues section and the community members will try to help you out.