From 53aea13e4f2da9cf4b2dc2b177321550a2c2dd94 Mon Sep 17 00:00:00 2001 From: DarkSun Date: Sat, 4 Sep 2021 05:03:10 +0800 Subject: [PATCH] =?UTF-8?q?=E9=80=89=E9=A2=98[tech]:=2020210903=20Install?= =?UTF-8?q?=20ONLYOFFICE=20Docs=20on=20Fedora=20Linux=20with=20Podman=20an?= =?UTF-8?q?d=20connect=20it=20with=20Nextcloud?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit sources/tech/20210903 Install ONLYOFFICE Docs on Fedora Linux with Podman and connect it with Nextcloud.md --- ...th Podman and connect it with Nextcloud.md | 211 ++++++++++++++++++ 1 file changed, 211 insertions(+) create mode 100644 sources/tech/20210903 Install ONLYOFFICE Docs on Fedora Linux with Podman and connect it with Nextcloud.md diff --git a/sources/tech/20210903 Install ONLYOFFICE Docs on Fedora Linux with Podman and connect it with Nextcloud.md b/sources/tech/20210903 Install ONLYOFFICE Docs on Fedora Linux with Podman and connect it with Nextcloud.md new file mode 100644 index 0000000000..10d78e60bd --- /dev/null +++ b/sources/tech/20210903 Install ONLYOFFICE Docs on Fedora Linux with Podman and connect it with Nextcloud.md @@ -0,0 +1,211 @@ +[#]: subject: "Install ONLYOFFICE Docs on Fedora Linux with Podman and connect it with Nextcloud" +[#]: via: "https://fedoramagazine.org/instal-onlyoffice-docs-on-fedora-linux-with-podman/" +[#]: author: "kseniya_fedoruk https://fedoramagazine.org/author/kseniya_fedoruk/" +[#]: collector: "lujun9972" +[#]: translator: " " +[#]: reviewer: " " +[#]: publisher: " " +[#]: url: " " + +Install ONLYOFFICE Docs on Fedora Linux with Podman and connect it with Nextcloud +====== + +![][1] + +Photo by [Chris Leggat][2] on [Unsplash][3] + +If you need a reliable office suite for online editing and collaboration within your sync & share platform, you can try ONLYOFFICE Docs. In this tutorial, we learn how to install it on your Fedora Linux with Podman and discover the ONLYOFFICE-Nextcloud integration. + +### What is ONLYOFFICE Docs + +[ONLYOFFICE Docs][4] (Document Server) is an open-source office suite distributed under GNU AGPL v3.0. It is comprised of web-based viewers and collaborative editors for text documents, spreadsheets, and presentations. The suite is highly compatible with OOXML formats (docx, xlsx, pptx). + +A brief features overview includes: + + * Full set of editing and styling tools, operations with fonts and styles, paragraph and text formatting. + * Inserting and customizing all kinds of objects: shapes, charts, text art, text boxes, etc. + * Academic formatting and navigation: endnotes, footnotes, table of contents, bookmarks. + * Content Controls for creating digital forms and templates. + * Extending functionality with plugins, building your own plugins using API. + * Collaborative features: real-time and paragraph-locking co-editing modes, review and track changes, comments and mentions, integrated chat, version history. + * Flexible access permissions: edit, view, comment, fill forms, review, restriction on copying, downloading, and printing, custom filter for spreadsheets. + + + +![][5] + +You can integrate ONLYOFFICE Docs with various cloud services such as Nextcloud, ownCloud, Seafile, Alfresco, Plone, etc. What’s more, developers can embed the editors into their own solutions.  + +You can also use the suite together with [ONLYOFFICE Groups][6], a free open-source collaboration platform distributed under Apache 2.0. The complete solution is available as [ONLYOFFICE Workspace.][7] + +### What is Podman + +Podman is a daemonless container engine for developing, managing, and running OCI containers on your Linux system. Users can run containers either as root or in rootless mode.  + +It is available by default on Fedora Workstation. If it’s not the case, install podman with the command: + +``` +sudo dnf install podman +``` + +### What you need for ONLYOFFICE Docs installation + + * CPU: single core 2 GHz or better + * RAM: 2 GB or more + * HDD: at least 40 GB of free space + * At least 4 GB of swap + + + +### Install and run ONLYOFFICE Docs + +Start with the following commands for the root-privileged deployment. This creates directories for mounting from the container to the host system: + +``` +$ sudo mkdir -p /app/onlyoffice/DocumentServer/logs \ + /app/onlyoffice/DocumentServer/data \ + /app/onlyoffice/DocumentServer/lib \ + /app/onlyoffice/DocumentServer/db +``` + +Now mount these directories via podman. When prompted, select the image from docker.io): + +``` +$ sudo podman run -i -t -d -p 80:80 -p 443:443 --restart=always \ + -v /app/onlyoffice/DocumentServer/logs:/var/log/onlyoffice:Z \ + -v /app/onlyoffice/DocumentServer/data:/var/www/onlyoffice/Data:Z \ + -v /app/onlyoffice/DocumentServer/lib:/var/lib/onlyoffice:Z \ + -v /app/onlyoffice/DocumentServer/db:/var/lib/postgresql:Z \ + -u root onlyoffice/documentserver:latest +``` + +Please note that rootless deployment is NOT recommended for ONLYOFFICE Docs. + +To check that ONLYOFFICE is working correctly, run: + +``` +$ sudo podman exec $(sudo podman ps -q) sudo supervisorctl start ds:example +``` + +Then, open  and click the word “here” in the line _Once started the example will be available here_. Or look for the orange “button” that says “GO TO TEST EXAMPLE”. This opensthe test example where you can create a document. + +Alternatively, to install ONLYOFFICE Docs, you can build an image in podman: + +``` +$ git clone https://github.com/ONLYOFFICE/Docker-DocumentServer.git +$ cd Docker-DocumentServer/ +$ sudo podman build --tag oods6.2.0:my -f ./Dockerfile +``` + +Or build an image from the Docker file in buildah (you need root access): + +``` +$ buildah bud --tag oods6.2.0buildah:mybuildah -f ./Dockerfile +``` + +### Activate HTTPS + +To secure the application via SSL basically two things are needed: + + * Private key (.key) + * SSL certificate (.crt) + + + +So you need to create and install the following files: + +``` +/app/onlyoffice/DocumentServer/data/certs/onlyoffice.key +/app/onlyoffice/DocumentServer/data/certs/onlyoffice.crt +``` + +You can get certificates in several ways depending on your requirements: buy from certification centers, request from [Let’s Encrypt,][8] or create a [self-signed certificate][9] through OpenSSL (note that self-signed certificates are not recommended for production use). + +Secure ONLYOFFICE Docs switching to the HTTPS protocol: + +``` +$ sudo mkdir /app/onlyoffice/DocumentServer/data/certs +$ sudo cp onlyoffice.crt /app/onlyoffice/DocumentServer/data/certs/ +$ sudo cp onlyoffice.key /app/onlyoffice/DocumentServer/data/certs/ +$ sudo chown -R 100108:100111 /app/onlyoffice/DocumentServer/data/certs/ +# find the podman container id +$ sudo podman ps -a +# restart the container to use the new certificate +$ sudo podman restart {container_id} +``` + +Now you can integrate ONLYOFFICE Docs with the platform you already use and start working with your documents. + +### ONLYOFFICE-Nextcloud integration example + +To connect ONLYOFFICE Docs and Nextcloud (or any other DMS), you need a connector. This is an integration app that functions like a bridge between two services.   + +In case you’re new to Nextcloud, you can install it with Podman following [this tutorial][10].    + +If you already have Nextcloud installed, you just need to install and activate the connector. Do this with the following steps: + + 1. launch your Nextcloud as an admin, + 2. click your user icon in the upper right corner, + 3. switch to + Apps, + 4. find ONLYOFFICE in the list of available applications in the section “Office & text”, + 5. click the Download and enable button.  + + + +ONLYOFFICE now appears in the Active apps section and you can go ahead with the configuration.  + +Select your user icon again in the upper right corner -> Settings -> Administration -> ONLYOFFICE. On the settings page, you can configure: + + * The address of the machine with ONLYOFFICE installed + * Secret key (JWT that protects docs from unauthorized access) + * ONLYOFFICE and Nextcloud addresses for internal requests + + + +![][11] + +You can also adjust additional settings which are not mandatory but will make your user experience more comfortable: + + * Restrict access to the editors to user groups + * Enable/disable the Open file in the same tab option + * Select file formats that will be opened by default with ONLYOFFICE + * Customize editor interface + * Enable watermarking + + + +![][12] + +### Conclusion + +Installing ONLYOFFICE Docs on Fedora Linux with Podman is quite easy. It will give you a powerful office suite for integration into any Document Managemet System. +``` + +``` + + +-------------------------------------------------------------------------------- + +via: https://fedoramagazine.org/instal-onlyoffice-docs-on-fedora-linux-with-podman/ + +作者：[kseniya_fedoruk][a] +选题：[lujun9972][b] +译者：[译者ID](https://github.com/译者ID) +校对：[校对者ID](https://github.com/校对者ID) + +本文由 [LCTT](https://github.com/LCTT/TranslateProject) 原创编译，[Linux中国](https://linux.cn/) 荣誉推出 + +[a]: https://fedoramagazine.org/author/kseniya_fedoruk/ +[b]: https://github.com/lujun9972 +[1]: https://fedoramagazine.org/wp-content/uploads/2021/08/onlyoffice-podman-nextcloud-816x345.jpg +[2]: https://unsplash.com/@chris_legs?utm_source=unsplash&utm_medium=referral&utm_content=creditCopyText +[3]: https://unsplash.com/s/photos/sharing-writing?utm_source=unsplash&utm_medium=referral&utm_content=creditCopyText +[4]: https://www.onlyoffice.com/office-suite.aspx +[5]: https://fedoramagazine.org/wp-content/uploads/2021/07/ONLYOFFICE-Docs-dark-theme-1024x585.png +[6]: https://www.onlyoffice.com/collaboration-platform.aspx +[7]: https://www.onlyoffice.com/workspace.aspx +[8]: https://letsencrypt.org/ +[9]: https://www.server-world.info/en/note?os=Fedora_31&p=ssl&f=1 +[10]: https://fedoramagazine.org/nextcloud-20-on-fedora-linux-with-podman/ +[11]: https://fedoramagazine.org/wp-content/uploads/2021/07/1-server-settings-1024x611.png +[12]: https://fedoramagazine.org/wp-content/uploads/2021/07/nc-settings-1-1024x574.png