Help: How to modify the port number of docserice.exe?

Docs
1

d08a0e3255e3b1c3f7534f1473060fad
d08a0e3255e3b1c3f7534f1473060fad2674×1064 326 KB

2

Hey @dream, :wave:

Just to make sure I’m on the same page — are you trying to change the port for the ONLYOFFICE Docs service (docservice.exe)? If so, could you share why you need to modify it?

3

Yes, because port 8000 conflicts with another application port.

4

Hello @dream

According to the official installation guide:

By default, ONLYOFFICE Docs listens to the incoming connections using port 80 . Starting with version 4.3 you can change the port for ONLYOFFICE Docs if you plan to use it instead of the default one. To do that, run the executable file with the parameter:

onlyoffice-documentserver.exe /DS_PORT=<PORT_NUMBER>

Where <PORT_NUMBER> is the number of port you want ONLYOFFICE Docs to use.

5

The command ‘onlyoffice-documentserver.exe /DS_PORT=9090’ has been modified.However, it still occupies port 8000 through detection.

178cc2f3-d28f-4140-81d1-dcd417567fe1
178cc2f3-d28f-4140-81d1-dcd417567fe11555×644 61 KB

6

Hey @dream, :wave:

Thanks for the update and screenshot — I see port 8000 is still in use even after setting /DS_PORT=9090.

To clarify: the /DS_PORT parameter changes the main ONLYOFFICE Docs listener port (the one the server binds to for external connections, e.g., via browser or editor integration). However, DocService (docservice.exe) internally communicates with other components on port 8000.

So:

  • Your main Docs access will now be on port 9090.
  • But internal services, including DocService, will still use 8000 for inter-process communication.

Solution:

Since port 8000 conflicts with another app, you have two options:

  1. Free up port 8000 on your system (stop the conflicting app or reconfigure it).
  2. Run ONLYOFFICE Docs in a container/VM where port 8000 is isolated.

We’re aware this limits flexibility on Windows installs — no current workaround to change the internal DocService port.

7

Hi @dream

It seems I misled you earlier. Actually, it should be possible to change the docservice port through the configuration file — I hadn’t noticed that before.
You can update it here:
https://github.com/ONLYOFFICE/server/blob/master/Common/config/default.json#L321

However, you’ll also need to update the corresponding value in Nginx for the change to take effect:
https://github.com/ONLYOFFICE/document-server-package/blob/master/common/documentserver/nginx/includes/http-common.conf.m4#L2

Please check if this approach works for you.
Still, by default, changing port 8000 is not officially supported.