# How to install Collabora built-in CODE server on Nextcloud snap

**URL:** <https://help.nextcloud.com/t/how-to-install-collabora-built-in-code-server-on-nextcloud-snap/231142>\
**Category:** 📑 How to\
**Tags:** snap, letsencrypt, dns, collabora-built-in, nextcloud-office\
**Created:** [August 28, 2025, 7:50pm UTC](https://help.nextcloud.com/t/how-to-install-collabora-built-in-code-server-on-nextcloud-snap/231142 "2025-08-28T19:50:45Z")\
**Posts on this page:** 2\
**Page:** 1

<div class="post-metadata">

**Author:** ![scubamuc](https://help.nextcloud.com/user_avatar/help.nextcloud.com/scubamuc/32/63165_2.png) [@scubamuc](https://help.nextcloud.com/u/scubamuc)\
**Post date:** [August 28, 2025, 7:50pm UTC](https://help.nextcloud.com/t/how-to-install-collabora-built-in-code-server-on-nextcloud-snap/231142/1 "2025-08-28T19:50:45Z")

</div>

# How to install Collabora built-in CODE server on Nextcloud snap

[Collabora built-in CODE & Nextcloud Office configuration on Nextcloud snap](https://github.com/nextcloud-snap/nextcloud-snap/wiki/Configure-CODE-and-Nextcloud-office-for-Nextcloud-snap)

[Collabora Online](https://www.collaboraonline.com) is a LibreOffice-based online office suite with collaborative editing, which supports all major documents, spreadsheet and presentation file formats and works together with all modern browsers. The [Nextcloud Office](https://apps.nextcloud.com/apps/richdocuments) integration app provides an interface for editing documents in Nextcloud with Collabora Online.

[Collabora built-in CODE Server](https://apps.nextcloud.com/apps/richdocumentscode) ( **C** ollabora **O** nline **D** evelopment **E** dition) and Nextcloud office are third party apps included in the default Nextcloud installation requiring individual configuration in Nextloud snap. It is perfect for testing, home use or small teams but not recommended for production environments. [Collabora Built-in CODE Server](https://apps.nextcloud.com/apps/richdocumentscode) together with [Nextcloud Office](https://apps.nextcloud.com/apps/richdocuments) enables editing Office documents within your Nextcloud instance.

> #### IMPORTANT!
> 
> **Nextcloud snap requirements**  
> Ensure that your Nextcloud instance is [encrypted with a valid certificate](https://help.nextcloud.com/t/how-to-manage-lets-encrypt-for-nextcloud-snap/216069) and that your [instance is publicly available](https://help.nextcloud.com/t/how-to-install-nextcloud-snap/216058#p-649475-domain-name-and-dns-4).
> 
> - 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.

## Required apps from Nextcloud app store

The default [Nextcloud snap installation](https://help.nextcloud.com/t/how-to-install-nextcloud-snap/216058) will include [Collabora built-in CODE Server](https://apps.nextcloud.com/apps/richdocumentscode) and [Nextcloud Office](https://apps.nextcloud.com/apps/richdocuments). These apps may be installed manually from the [Nextcloud app store](https://apps.nextcloud.com/) or via the [OCC management console](https://help.nextcloud.com/t/how-to-use-occ-management-console-for-nextcloud-snap/216111/2);

- Install Nextcloud office app from Nextcloud app store

```auto
sudo nextcloud.occ app:enable richdocuments 

```

- Install Collaora built-in CODE (richdocumentscode) app from Nextcloud app store

```auto
sudo nextcloud.occ app:enable richdocumentscode

```

## Procedure

### 1. Install packages on host

Install packages on **host** :

```auto
sudo apt install fontconfig glibc-source

```

### 2. Set Hostname and FQDN

Set host in `/etc/hosts` on host, see [**Hosts & FQDN**](https://help.nextcloud.com/t/how-to-manage-hosts-and-fqdn-for-nextcloud-snap/216109)

**Example for internet facing instance with automated (SSL):**

```auto
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

```

**Example for instance behind reverse proxy with termination:**

```auto
127.0.0.1 localhost
<your.reverse.proxy.ip> <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-url in Config-php

Set `overwrite.cli.url` in [config-php](https://help.nextcloud.com/t/how-to-edit-config-php-for-nextcloud-snap/218564) by adding the following line to your configuration:

```auto
  '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 value `https://your.domain.xyz` above will be the only allowed domain for editing documents in Nextcloud office! Any other [trusted domains](https://help.nextcloud.com/t/how-to-edit-config-php-for-nextcloud-snap/218564#p-655465-setting-trusted-domains-3) will not be accepted by Collabora Built-in CODE. So you may need to instruct your users.

### 4. Set trusted proxy in Config-php

Set [trusted proxy](https://help.nextcloud.com/t/how-to-edit-config-php-for-nextcloud-snap/218564#p-655465-setting-trusted-proxies-4) in [config-php](https://help.nextcloud.com/t/how-to-edit-config-php-for-nextcloud-snap/218564) if Nextcloud snap is behind a **reverse proxy**.

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

```

or issue command:

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

```

> #### CAUTION
> 
> Be aware that these values must be IPv4 address or IPv4 ranges in CIDR notation see [reverse proxy documentation](https://docs.nextcloud.com/server/stable/admin_manual/configuration_server/reverse_proxy_configuration.html)

### 5. Configure CODE

**5a.** Configure built-in 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 built-in 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.

![grafik](https://github.com/nextcloud-snap/nextcloud-snap/assets/54933878/c89e641d-ec54-4081-8e2d-7841b3b86072)

* * *

## Troubleshooting built-in CODE on Nextcloud snap

**Your documents are not loading?**

![Your image title](https://github.com/nextcloud-snap/nextcloud-snap/assets/54933878/8afc6365-07e8-4ad4-b81b-9fd4fa9de0c9)

- Loading built-in CODE after fresh install, app upgrade or after server restart may **take a while** , so be patient. See [here](https://github.com/CollaboraOnline/richdocumentscode#implementation)
  - some folks suggest installing `libfuse2` on host `sudo apt install libfuse2`

- For network connection issues, double check steps **1** to **4**
- To reset built-in 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](https://github.com/CollaboraOnline/richdocumentscode/issues/226)

* * *

> #### TIP
> 
> - [**How to configure collabora CODE for Nextcloud with docker**](https://help.nextcloud.com/t/collabora-code-for-nextcloud-with-docker/216725)

See also:

- [Hosts and FQDN](https://github.com/nextcloud-snap/nextcloud-snap/wiki/Hosts-and-FQDN-for-Nextcloud-snap)
- [HTTP and HTTPS port configuration](https://github.com/nextcloud-snap/nextcloud-snap/wiki/Port-configuration#http-and-https-port-configuration)
- [Putting Nextcloud snap behind a reverse proxy](https://github.com/nextcloud-snap/nextcloud-snap/wiki/Putting-the-snap-behind-a-reverse-proxy)
- [Let reverse proxy handle encryption](https://github.com/nextcloud-snap/nextcloud-snap/wiki/NGINX-proxy-manager)

* * *

---

<div class="post-metadata">

**Author:** ![scubamuc](https://help.nextcloud.com/user_avatar/help.nextcloud.com/scubamuc/32/63165_2.png) [@scubamuc](https://help.nextcloud.com/u/scubamuc)\
**Post date:** [August 28, 2025, 7:50pm UTC](https://help.nextcloud.com/t/how-to-install-collabora-built-in-code-server-on-nextcloud-snap/231142/2 "2025-08-28T19:50:57Z")

</div>


