# ![«Image: CODE»](images/code-logo.png "CODE") CODE

<!-- TODO: Add a video -->

```{note}
[Collabora Online Development Edition (CODE)](https://www.collaboraonline.com/code/) is based on [LibreOffice](https://www.libreoffice.org/).
It is designed to provide users with a free version of the online office suite, allowing individuals and small teams to access and test its features.
CODE is a valuable resource for those looking to utilize LibreOffice's capabilities in an online collaborative environment.
```

For this example we will run a [NextCloud](https://nextcloud.com/) server and CODE server using and share an office suite with a contact.

1. Download the [nextcloud_collabora.zip](../_static/downloads/nextcloud_collabora.zip) ZIP file and unzip it to reveal its contents.
2. Open a terminal in the unzipped folder.
3. Create your local environment file:
   ```bash
   cp .env.example .env
   ```

4. Edit `.env` and set strong values for at least:
   - `MYSQL_ROOT_PASSWORD`
   - `MYSQL_PASSWORD`
   - `NEXTCLOUD_ADMIN_PASSWORD`

   Keep these values unless you have a reason to change them:
   - `PUBLIC_HOST=localhost`
   - `EXPOSED_PORT=18080`

5. Start the stack:

   ```bash
   docker compose up -d
   ```

6. Open `http://localhost:18080` in your browser.
7. Sign in to Nextcloud using the admin credentials from `.env`.
8. In Jami, create a custom shared service with:
   - **Local host**: `127.0.0.1`
   - **Local port**: `18080`
   - **URI scheme**: `http`
   - **Preferred port on peer**: `18080`
9. Share that service with your contact.
10. Your contact opens your shared service in Jami, then opens `http://localhost:18080` on their machine.
11. Open a document in Nextcloud Files to verify collaborative editing works.

```{tip}
Need to reset everything (accounts, files, DB) and start fresh?

Run the following in the same folder:

```bash
docker compose down -v --remove-orphans
docker compose up -d
```