build_tools/develop/README.md

Docker

This directory containing instruction for developers, who want to change something in sdkjs or web-apps or server module, but don't want to compile pretty compilcated core product to make those changes.

System requirements

Windows

Note: You need the latest Docker Desktop for Windows installed.

Note: Docker Desktop does not start automatically after installation. You should manually start the Docker Desktop application.

Linux or macOS

Note: You need the latest Docker version installed.

You might need to pull onlyoffice/documentserver image:

Note: Do not prefix docker command with sudo. This instruction show how to use docker without sudo.

Create develop Docker Images

To create a image with the ability to include external non-minified sdkjs code, use the following commands:

Clone development environment to work dir

git clone -b feature/docker-instruction https://github.com/ONLYOFFICE/build_tools.git
cd build_tools/develop

Modify Dockerfile

Windows (PowerShell)

cd build_tools/develop
(Get-Content Dockerfile) | ForEach-Object { $_ -replace "https://github.com", "-b feature/docker-instruction https://github.com" } | Set-Content Dockerfile

Linux or macOS

cd build_tools/develop
sed -i 's,https://github.com,-b feature/docker-instruction https://github.com,' Dockerfile

Modify Docker Images

docker pull onlyoffice/documentserver
docker build -t documentserver-develop .

Note: The dot at the end is required.

Clone development modules

At first clone modules to the work dir

• sdkjs repo is located here
• web-apps repo is located here
• server repo is located here

cd ../..
git clone https://github.com/ONLYOFFICE/sdkjs.git
git clone https://github.com/ONLYOFFICE/web-apps.git
git clone https://github.com/ONLYOFFICE/server.git

Start server with external folders

To mount external folders to the container, you need to pass the "-v" parameter along with the relative paths to the required folders.
The folders sdkjs and web-apps are required for proper development workflow. The folders server is optional

Note: ONLYOFFICE server uses port 80. Look for another application using port 80 and stop it

Note: server start with sdkjs and web-apps takes 15 minutes and takes 20 minutes with server

Note: Run command from work dir with development modules

Windows (PowerShell)

run with sdkjs and web-apps

docker run -i -t -p 80:80 --restart=always -v $pwd/sdkjs:/var/www/onlyoffice/documentserver/sdkjs -v $pwd/web-apps:/var/www/onlyoffice/documentserver/web-apps documentserver-develop

run with sdkjs, web-apps and server

docker run -i -t -p 80:80 --restart=always -v $pwd/sdkjs:/var/www/onlyoffice/documentserver/sdkjs -v $pwd/web-apps:/var/www/onlyoffice/documentserver/web-apps -v $pwd/server:/var/www/onlyoffice/documentserver/server documentserver-develop

Linux or macOS

run with sdkjs and web-apps

docker run -i -t -p 80:80 --restart=always -v $(pwd)/sdkjs:/var/www/onlyoffice/documentserver/sdkjs -v $(pwd)/web-apps:/var/www/onlyoffice/documentserver/web-apps documentserver-develop

run with sdkjs, web-apps and server

docker run -i -t -p 80:80 --restart=always -v $(pwd)/sdkjs:/var/www/onlyoffice/documentserver/sdkjs -v $(pwd)/web-apps:/var/www/onlyoffice/documentserver/web-apps -v $(pwd)/server:/var/www/onlyoffice/documentserver/server documentserver-develop

Open editor

After the server starts successfully, you will see Docker log messages like this

[Date] [WARN] [localhost] [docId] [userId] nodeJS

To try the document editor, open a browser tab and type http://localhost/example into the URL bar.

Note: Disable ad blockers for localhost page. It may block some scripts (like Analytics.js)

Modify sources

To change something in sdkjs do the following steps

1)Edit source file. Let's insert an image url into each open document. Do the following command.

Windows (PowerShell)

(Get-Content sdkjs/common/apiBase.js) -replace "this\.sendEvent\('asc_onDocumentContentReady'\);", "this.sendEvent('asc_onDocumentContentReady');this.AddImageUrl(['http://localhost/example/images/logo.png']);"  | Set-Content sdkjs/common/apiBase.js

Linux or macOS

sed -i "s,this.sendEvent('asc_onDocumentContentReady');,this.sendEvent('asc_onDocumentContentReady');this.AddImageUrl(['http://localhost/example/images/logo.png']);," sdkjs\common\apiBase.js

2)Delete browser cache or hard reload the page Ctrl + Shift + R

3)Open new file in browser

To change something in server do the following steps

1)Edit source file. Let's send "Hello World!" chart message every time a document is opened.Do the following command

Windows (PowerShell)

(Get-Content server/DocService/sources/DocsCoServer.js) -replace 'opt_hasForgotten, opt_openedAt\) \{', 'opt_hasForgotten, opt_openedAt) {yield* onMessage(ctx, conn, {"message": "Hello World!"});' | Set-Content server/DocService/sources/DocsCoServer.js

Linux or macOS

sed -i 's#opt_hasForgotten, opt_openedAt) {#opt_hasForgotten, opt_openedAt) {yield* onMessage(ctx, conn, {"message": "Hello World!"});#' server\DocService\sources\DocsCoServer.js

2)Restart document server process

docker exec -it CONTAINER_ID supervisorctl restart all

3)Open new file in browser