|
1 | | -# ns8-euro-office |
| 1 | +# ns8-onlyoffice |
2 | 2 |
|
3 | | -This is the Euro-Office app for NethServer 8. |
| 3 | +This is the Onlyoffice app for NethServer 8. |
4 | 4 |
|
5 | 5 | ## Install |
6 | 6 |
|
7 | 7 | Install via Software center: |
8 | 8 |
|
9 | 9 | - Add a Software repository pointing to `https://repo.mrmarkuz.com/ns8/updates/`, check out the [repo webpage](https://repo.mrmarkuz.com) how to do it. |
10 | | - - Install Euro-Office via Software Center |
| 10 | + - Install Onlyoffice via Software Center |
11 | 11 |
|
12 | 12 | Instantiate the module on CLI with: |
13 | 13 |
|
14 | | - add-module ghcr.io/mrmarkuz/euro-office:latest 1 |
| 14 | + add-module ghcr.io/mrmarkuz/onlyoffice:latest 1 |
15 | 15 |
|
16 | 16 | The output of the command will return the instance name. |
17 | 17 | Output example: |
18 | 18 |
|
19 | | - {"module_id": "euro-office1", "image_name": "euro-office", "image_url": "ghcr.io/mrmarkuz/euro-office:latest"} |
| 19 | + {"module_id": "onlyoffice1", "image_name": "onlyoffice", "image_url": "ghcr.io/mrmarkuz/onlyoffice:latest"} |
20 | 20 |
|
21 | 21 | ## Configure |
22 | 22 |
|
23 | | -The FQDN needs to be configured in the Web UI app settings. The FQDN is required. It should be a unique FQDN that's not already used in your NS8 else Euro Office won't be reachable. |
| 23 | +The FQDN needs to be configured in the Web UI app settings. The FQDN is required. It should be a unique FQDN that's not already used in your NS8 else Onlyoffice won't be reachable. |
24 | 24 |
|
25 | 25 | ## JWT Secret |
26 | 26 |
|
27 | | -To get the JWT secret that needs to be configured in client apps like Nextcloud: (in this example the instance is named euro-office1) |
| 27 | +To get the JWT secret that needs to be configured in client apps like Nextcloud: (in this example the instance is named onlyoffice1) |
28 | 28 |
|
29 | | - runagent -m euro-office1 grep JWT_SECRET environment |
| 29 | + runagent -m onlyoffice1 grep JWT_SECRET environment |
30 | 30 |
|
31 | 31 | ## Nextcloud |
32 | 32 |
|
33 | | -- Install the Nextcloud Office 11.0.0 app |
34 | | -- Go to Nextcloud administration Nextcloud Office app settings |
35 | | -- Set the "Nextcloud Office address" that is the FQDN of the Eurooffice app like `https://eurooffice.domain.tld` |
36 | | -- Set the "Secret key" that you got from the previous chapter |
| 33 | +- Install the ONLYOFFICE app |
| 34 | +- Go to Nextcloud administration Onlyoffice app settings |
| 35 | +- Set the "Onlyoffice Docs address" that is the FQDN of the Onlyoffice app. |
| 36 | +- Set the "Secret key" that you got from the previous chapter. |
37 | 37 |
|
38 | | -## Fetch documents from a private IP |
| 38 | +## Ad blockers |
39 | 39 |
|
40 | | -If Nextcloud resolves to a private IP an environment variable needs to be added. |
| 40 | +Since Onlyoffice 9.4 (ns8-onlyoffice 1.1.7) ad blockers may block Onlyoffice so you may need to add an exception. |
41 | 41 |
|
42 | | -In the following examples euro-office1 is used as app instance name, please change it to match your environment. |
| 42 | +## Customize configuration |
43 | 43 |
|
44 | | -Edit the environment file and add "ALLOW_PRIVATE_IP_ADDRESS=true": |
| 44 | +Since this setup uses the official Docker image, the local.json file is regenerated each time the container starts, meaning it’s not directly mappable or persistent on the host. Any manual changes made to local.json inside the container are lost after a restart. |
45 | 45 |
|
46 | | - runagent -m euro-office1 nano environment |
| 46 | +The proper workaround is to create the file `/home/onlyoffice1/.local/share/containers/storage/volumes/onlyoffice-etc/_data/local-production-linux.json`. This file takes precedence over the default configuration and remains persistent across container restarts. Any changes made there are applied automatically on startup. |
| 47 | + |
| 48 | +## Use a self signed cert or how to disable the certificate check |
| 49 | + |
| 50 | +Open the Onlyoffice web app in your browser and allow the self-signed certificate to avoid an `ONLYOFFICE cannot be reached. Please contact admin` error in Nextcloud. |
| 51 | + |
| 52 | +In the following examples onlyoffice6 is used as app instance name, please change it to match your environment. |
| 53 | + |
| 54 | +Edit the environment file and add "USE_UNAUTHORIZED_STORAGE=true": |
| 55 | + |
| 56 | + runagent -m onlyoffice1 nano environment |
47 | 57 |
|
48 | 58 | Alternative command to add the environment variable: |
49 | 59 |
|
50 | | - runagent -m euro-office1 bash -c "grep -q ALLOW_PRIVATE_IP_ADDRESS environment || echo ALLOW_PRIVATE_IP_ADDRESS=true >> environment" |
| 60 | + runagent -m onlyoffice1 bash -c "grep -q USE_UNAUTHORIZED_STORAGE environment || echo USE_UNAUTHORIZED_STORAGE=true >> environment" |
51 | 61 |
|
52 | | -Restart euro-office to apply the changes: |
| 62 | +Restart onlyoffice to apply the changes: |
53 | 63 |
|
54 | | - runagent -m euro-office1 systemctl --user restart euro-office-app |
| 64 | + runagent -m onlyoffice1 systemctl --user restart onlyoffice-app |
55 | 65 |
|
56 | 66 | ## Uninstall |
57 | 67 |
|
58 | 68 | To uninstall the instance: |
59 | 69 |
|
60 | | - remove-module --no-preserve euro-office1 |
| 70 | + remove-module --no-preserve onlyoffice1 |
0 commit comments