Changes

Jump to navigation Jump to search
2,381 bytes added ,  03:08, 8 July 2022
no edit summary
Line 1: Line 1: −
this page described how to install onlyoffice '''document server''' as a docker container on SME10as '''server gateway'''. So we can use it from nextcloud.
+
{{Languages}}
 +
<!-- here we define the contrib name variable -->
 +
<!-- we get the page title, remove suffix for translated version; if needed you can define there with the value you want-->
 +
{{#vardefine:contribname| {{lc: {{#titleparts:  {{BASEPAGENAME}} |1}} }} }}
 +
{{#vardefine:smecontribname| smeserver-{{lc: {{#titleparts:  {{BASEPAGENAME}} |1}} }} }}
 +
<!-- we define the language -->
 +
{{#vardefine:lang| {{lc:  {{#titleparts:    {{PAGENAME}} | | -1}}  }} |en }}{{Infobox contribs
 +
| name = {{#var:contribname}}
 +
| image = Onlyoffice.png
 +
| description_image = {{#var:contribname}} logo
 +
| maintainer = Unnilennium
 +
| licence = Mozilla Public License
 +
| url = https://www.onlyoffice.com
 +
| video =
 +
| category = Cloud
 +
| tags = Online Office,Nextcloud,Document Editor,Cloud
 +
}}
 +
This page describes how to install onlyoffice '''document server''' as a rpm contrib. This is of particular interest if you use [[Nextcloud]]
   −
this is early beta.
+
=== Version ===
 +
{{#smeversion: {{#var:smecontribname}} }}
   −
== install ==
+
=== Install ===
<syntaxhighlight lang="bash">
+
before proceeding you should have [[Nextcloud]] installed, and having a dedicated domain pointing to your server. This domain should be different from nextcloud domain.  
yum install smeserver-docker
+
You should also consider isntalling and configuring [[Letsencrypt]] to have a dedicated cert per domain.
</syntaxhighlight>then do where you must replace 192.168.80.117 by your SME LAN IP
+
In case you are limited in the use of extra domain you might use a dedicated port to use nginx externally, but this add some limit in term of ssl certificate, and we suggest to reconsider the dedicated domain.
   −
<syntaxhighlight lang="bash">
+
<tabs container="">
docker run -i -t -d --name onlyoffice -p 8080:80  \
+
<tab name="For SME 10">
      --dns=192.168.80.117  \
+
yum -y install https://downloads.sourceforge.net/project/mscorefonts2/rpms/msttcore-fonts-installer-2.6-1.noarch.rpm --enablerepo=smecontribs
      -v /app/onlyoffice/DocumentServer/logs:/var/log/onlyoffice \
+
yum install smeserver-extrarepositories-pgsql  smeserver-extrarepositories-onlyoffice -y
      -v /app/onlyoffice/DocumentServer/data:/var/www/onlyoffice/Data \
+
db yum_repositories setprop pgsql13 status enabled
      -v /app/onlyoffice/DocumentServer/rabbitmq:/var/lib/rabbitmq \
+
signal-event yum-modify
      -v /app/onlyoffice/DocumentServer/redis:/var/lib/redis \
+
yum --enablerepo=smecontribs install {{#var:smecontribname}}
      -v /app/onlyoffice/DocumentServer/lib:/var/lib/onlyoffice \
  −
      -v /app/onlyoffice/DocumentServer/db:/var/lib/postgresql \
  −
      onlyoffice/documentserver
     −
</syntaxhighlight>
+
then, if you have dedicated subdomain and use let's Encrypt (or have trusted certs)
 +
MYDOMAIN="onlyoffice.mydomain.com"
 +
config setprop onlyoffice VirtualHost $MYDOMAIN RejectUnauthorized true access local
 +
db domains set $MYDOMAIN domain Content Primary Description onlyoffice Nameservers localhost letsencryptSSLcert enabled TemplatePath Onlyoffice
 +
signal-event domain-create $MYDOMAIN
 +
expand-template /etc/dehydrated/domains.txt
 +
dehydrated -c
 +
signal-event smeserver-onlyoffice-update
   −
TODO : httpd templates
+
then, if you share one domain/subdomain and you have trusted certificate for it [will use dedicated port 8082, needs opening behind a firewall]
 +
config setprop onlyoffice RejectUnauthorized true access public
 +
signal-event smeserver-onlyoffice-update
   −
TODO: iptables templates
+
then, if you do not have trusted certs, but only self signed, and only one domain/subdomain [will use dedicated port 8082, needs opening behind a firewall]
 +
config setprop onlyoffice RejectUnauthorized false access public
 +
signal-event smeserver-onlyoffice-update
   −
== update ==
  −
<syntaxhighlight lang="bash">
  −
docker pull onlyoffice/documentserver:latest
     −
cp -a /app/onlyoffice/DocumentServer/ /backuponlyoffice
+
NB: in two last situations you could choose private if you only want it to be accessible from LAN.
   −
docker stop onlyoffice
+
</tab>
docker rm onlyoffice
+
</tabs>
docker run -i -t -d --name onlyoffice -p 8080:80  \
  −
      --dns=192.168.80.117  \
  −
      -v /app/onlyoffice/DocumentServer/logs:/var/log/onlyoffice \
  −
      -v /app/onlyoffice/DocumentServer/data:/var/www/onlyoffice/Data \
  −
      -v /app/onlyoffice/DocumentServer/rabbitmq:/var/lib/rabbitmq \
  −
      -v /app/onlyoffice/DocumentServer/redis:/var/lib/redis \
  −
      -v /app/onlyoffice/DocumentServer/lib:/var/lib/onlyoffice \
  −
      -v /app/onlyoffice/DocumentServer/db:/var/lib/postgresql \
  −
      onlyoffice/documentserver
  −
#wait 5 min and then
  −
docker restart onlyoffice
  −
</syntaxhighlight>then you have to add back your secrets<syntaxhighlight lang="bash">
  −
docker
  −
apt update
  −
mcedit  /etc/onlyoffice/documentserver/local.json
  −
exit
  −
docker restart onlyoffice
  −
</syntaxhighlight>
     −
== useful commands ==
  −
<syntaxhighlight lang="bash">
  −
# stop onlyoffice
  −
docker stop --name onlyoffice
  −
#list containers
  −
docker container ls -a
  −
#list images
  −
docker images
  −
# access to the container
  −
docker exec -it onlyoffice bash
  −
</syntaxhighlight>
     −
== sources ==
+
 
* https://hub.docker.com/r/onlyoffice/documentserver/
+
===Configuration===
* https://github.com/ONLYOFFICE/Docker-DocumentServer
+
you can list the available configuration with the following command :
* https://ma.ttias.be/update-docker-container-latest-version/
+
config show {{#var:contribname}}
* https://www.howtoforge.com/tutorial/how-to-update-onlyoffice-to-version-95-with-docker/
+
Some of the properties are not shown, but are defaulted in a template or a script. Here a more comprehensive list with default and expected values :
* https://docs.docker.com/config/containers/container-networking/
+
{| class="wikitable"
* https://help.nextcloud.com/t/nextcloud-onlyoffice-integration-document-server-getconverteduri-on-check-error-error-while-downloading-the-document-file-to-be-converted/57393
+
!property
 +
!default
 +
!values
 +
!
 +
|-
 +
|dbname
 +
|onlyoffice
 +
|string
 +
|for pgsql
 +
|-
 +
|dbuser
 +
|onlyoffice
 +
|string
 +
|for pgsql
 +
|-
 +
|dbpass
 +
|**generated**
 +
|string
 +
|for pgsql
 +
|-
 +
|VirtualHost
 +
|
 +
|domain name
 +
|e.g. onlyoffice.domain.com
 +
|-
 +
|TCPPort
 +
|8082
 +
|port number
 +
|port where https connection can be done
 +
|-
 +
|token
 +
|*generated*
 +
|string > 32 chars
 +
|secret key to be able to use the service
 +
|-
 +
|RejectUnauthorized
 +
|
 +
|true/false
 +
|true if empty; will reject the connection from untrusted ssl certs to the onlyoffice service. It is also used for nextcloud to reject non trusted cert from onlyoffice.
 +
|-
 +
|access
 +
|local
 +
|local,private, public
 +
|
 +
|-
 +
|status
 +
|enabled
 +
|enabled,disabled
 +
|}
 +
 
 +
===Uninstall===
 +
yum remove {{#var:smecontribname}}  {{#var:contribname}}
 +
 
 +
=== Bugs===
 +
Please raise bugs under the SME-Contribs section in [http://bugs.contribs.org/enter_bug.cgi bugzilla]
 +
and select the {{#var:smecontribname}} component or use {{BugzillaFileBug|product=SME%20Contribs|component={{#var:smecontribname}}|title=this link}}
 +
 
 +
Below is an overview of the current issues for this contrib:{{#bugzilla:columns=id,product,version,status,summary|sort=id|order=desc|component={{#var:smecontribname}} |noresultsmessage=No open bugs found.}}
 +
 
 +
===Changelog===
 +
Only released version in smecontrib are listed here.
 +
{{#smechangelog: {{#var:smecontribname}} }}
 +
 
 +
 
 +
===See Also===
 +
# https://helpcenter.onlyoffice.com/installation/docs-community-install-centos.aspx
 +
# https://sourceforge.net/projects/mscorefonts2
 +
# https://helpcenter.onlyoffice.com/installation/docs-community-proxy.aspx
 +
# https://github.com/ONLYOFFICE/DocumentServer/releases
 +
# https://helpcenter.onlyoffice.com/onlyoffice-editors/onlyoffice-document-editor/helpfulhints/advancedsettings.aspx
 +
 
 +
 
 +
[[Category:Contrib]]
Super Admin, Wiki & Docs Team, Bureaucrats, Interface administrators, Administrators
3,250

edits

Navigation menu