Configure CODE and Nextcloud office for Nextcloud snap

Built-in CODE Server and Nextcloud office are third party apps included in the default Nextcloud installation routine requiring individual configuration. We cannot support every scenario so you may need to do some research for your personal setup.

The following configurations were tested on a fresh Ubuntu Server 22.04 LTS for for x86_64 processor and Nextcloud snap latest/stable considering two scenarios:

• Nextcloud snap is an internet facing instance with automated (SSL) HTTPS encryption using Lets Encrypt without a reverse proxy.
• Nextcloud snap is behind a reverse proxy which handles (SSL) HTTPS encryption and redirects only http to the Nextcloud snap.

1. Install missing packages

Install missing packages on host:

sudo apt install fontconfig glibc-source

2. Set Hostname and FQDN

Set host in /etc/hosts on host, see Hosts & FQDN

Example:

127.0.0.1       localhost
127.0.1.1       your.domain.xyz hostname

## The following lines are desirable for IPv6 capable hosts
::1     ip6-localhost ip6-loopback
fe00::0 ip6-localnet
ff00::0 ip6-mcastprefix
ff02::1 ip6-allnodes
ff02::2 ip6-allrouters

3. Set overwrite-cli in Config-php

Set overwrite.cli.url in config-php by adding the following line to your configuration:

  'overwrite.cli.url' => 'https://your.domain.xyz',

or issue command:

sudo nextcloud.occ config:system:set overwrite.cli.url --value="https://your.domain.xyz"

Be aware that the the value https://your.domain.xyz above will be the only allowed domain for editing documents in Nextcloud office! Any other trusted domains will not be accepted by CODE. So you may need to instruct your users.

4. Set trusted proxy in Config-php

Set trusted proxy in config-php if Nextcloud snap is behind a reverse proxy.

  'trusted_proxies' => 
    array (
      0 => 'your.proxy.ip',
     ),

or issue command:

sudo nextcloud.occ config:system:set trusted_proxies 0 --value="your.proxy.ip" ;

5. Configure CODE

5a. Configure CODE & Office for Nextcloud snap on AMD64:
These steps (in sequence) are required to reconfigure/reset and configure CODE & Nextcloud office on Nextcloud snap.

1. disable CODE: sudo nextcloud.occ app:disable richdocumentscode
2. disable Office: sudo nextcloud.occ app:disable richdocuments
3. delete configs: sudo nextcloud.occ config:app:delete richdocuments public_wopi_url
4. delete configs: sudo nextcloud.occ config:app:delete richdocuments wopi_url
5. enable Office: sudo nextcloud.occ app:enable richdocuments
6. enable CODE: sudo nextcloud.occ app:enable richdocumentscode

5b. Configure CODE & Office for Nextcloud snap on ARM64:
These steps (in sequence) are required to reconfigure/reset and configure CODE & Nextcloud office on Nextcloud snap.

1. disable CODE: sudo nextcloud.occ app:disable richdocumentscode_arm64
2. disable Office: sudo nextcloud.occ app:disable richdocuments
3. delete configs: sudo nextcloud.occ config:app:delete richdocuments public_wopi_url
4. delete configs: sudo nextcloud.occ config:app:delete richdocuments wopi_url
5. enable Office: sudo nextcloud.occ app:enable richdocuments
6. enable CODE: sudo nextcloud.occ app:enable richdocumentscode_arm64

You should get a green check if you've followed the above sequence for your device.

---

Troubleshooting CODE on Nextcloud snap

Your documents are not loading?

• Loading CODE after fresh install, app upgrade or after server restart may take a while, so be patient. See here
  • some folks suggest installing libfuse2 on host sudo apt install libfuse2
• For network connection issues, double check steps 1 to 4
• To reset CODE configuration, repeat steps 5a or 5b 1-6 in sequence depending on your device
• For ARM64 devices: There is an actual upstream issue with ARM64 devices since v23.5.5.
  Keep tracking and help with providing your system and setup information here

---

See also:

• Hosts and FQDN

• HTTP and HTTPS port configuration

• Putting Nextcloud snap behind a reverse proxy

• Let reverse proxy handle encryption