- China
- File Sync and Sharing
Try the Collabora Online Demo
How to Install and Test CODE
Install Docker and Docker Compose Plugin
1. Install Docker
sudo apt update
sudo apt install docker.io
sudo apt install docker-compose-plugin
sudo systemctl enable docker
2. Allow User to edit docker without sudo
sudo usermod -aG docker $USER
3. Log out and back in
Quick-Setup using provided compose files
1. Extract the download to a directory
For example: /home/user/applications/seafile
2. Edit your hosts file
Add the following entry to /etc/hosts
<your-ip-address> seafile.local
Example hosts file entry:
10.0.2.15 seafile.local
3. Edit the .env file
Set the following:
LOCAL_IP: Your local IP address
BASIC_STORAGE_PATH: /home/user/applications/seafile (whatever you set in step 1)
4. Run docker compose up -d
Make sure you are running compose from the created directory (where the compose file is saved)
5. Open Seafile in your webbrowser
Default credentials are:
admin@admin.local
secret
6. Edit seahub_settings.py
Path: /seafile-data/seafile/conf
OFFICE_SERVER_TYPE = 'CollaboraOffice'
ENABLE_OFFICE_WEB_APP = True
OFFICE_WEB_APP_BASE_URL = 'http://collabora:9980/hosting/discovery'
WOPI_ACCESS_TOKEN_EXPIRATION = 30 * 60 # seconds
OFFICE_WEB_APP_FILE_EXTENSION = (‘odp’, ‘ods’, ‘odt’, ‘xls’, ‘xlsb’, ‘xlsm’, ‘xlsx’,’ppsx’, ‘ppt’, ‘pptm’, ‘pptx’, ‘doc’, ‘docm’, ‘docx’)
OFFICE_PREVIEW_MAX_SIZE = 30 * 1024 * 1024 # preview size, 30 MB
ENABLE_OFFICE_WEB_APP_EDIT = True
OFFICE_WEB_APP_EDIT_FILE_EXTENSION = (‘odp’, ‘ods’, ‘odt’, ‘xls’, ‘xlsb’, ‘xlsm’, ‘xlsx’,’ppsx’, ‘ppt’, ‘pptm’, ‘pptx’, ‘doc’, ‘docm’, ‘docx’)
7. Restart docker containers
docker compose down && docker compose up -d
8. Open Collabora Online URL
https://seafile.local:6232
Accept unkown certificate and confirm “OK” is displayed
9. Create a document and try CODE
Open https://seafile.local
Your are now all setup and can try editing documents using CODE!
Manual Setup
For manual set up instructions, see the Seafile Official Documentation.
Setting up and configuring native CODE packages on Linux
Collabora provide native Linux packages in deb and rpm formats. For the deb format 3 platforms are supported: amd64, ppc64, and arm64. For the rpm format only amd64 is supported.
1. Import the signing key:
CODE packages are digitally signed by Collabora Productivity Ltd. First step is to import the signing key.
On deb based distributions use the following command:
mkdir -p /etc/apt/keyrings && cd /etc/apt/keyrings sudo wget -O collaboraonline-release-keyring.gpg https://collaboraoffice.com/downloads/gpg/collaboraonline-release-keyring.gpg
On rpm based distributions use the following command:
wget https://www.collaboraoffice.com/repos/CollaboraOnline/CODE-rpm/repodata/repomd.xml.key && sudo rpm --import repomd.xml.key
2. Add CODE package repositories:
On deb based distributions create /etc/apt/sources.list.d/collaboraonline.sources with the following contents:
Types: deb URIs: https://www.collaboraoffice.com/repos/CollaboraOnline/CODE-deb Suites: ./ Signed-By: /etc/apt/keyrings/collaboraonline-release-keyring.gpg
On rpm based distributions use the following commands:
RHEL, CentOS, Fedora, etc.:
sudo yum-config-manager --add-repo https://www.collaboraoffice.com/repos/CollaboraOnline/CODE-rpm
SUSE:
sudo zypper ar 'https://www.collaboraoffice.com/repos/CollaboraOnline/CODE-rpm' 'CODE' sudo zypper mr -r 'CODE' # enable auto refresh
3. Install packages:
On deb based distributions use the following command:
sudo apt update && sudo apt install coolwsd code-brand
On RHEL, CentOS, Fedora, etc. use the following command:
sudo yum install coolwsd CODE-brand
On SUSE, use the following command:
sudo zypper ref && sudo zypper in coolwsd CODE-brand
This is the minimal installation, without localizations. For full installation install ‘collaboraoffice*’ packages.
4. Configuration:
Edit /etc/coolwsd/coolwsd.xml. Collabora Online (coolwsd) service runs via systemd. After editing the configuration file, you have to restart the service:
sudo systemctl restart coolwsd
Collabora Online logs into systemd journal by default. You can check the log with:
sudo journalctl -u coolwsd
The default configuration is looking for an SSL certificate and key, which are not present, so probably it’s the best to disable SSL, and optionally enable SSL termination, then set up the reverse proxy.
It is highly recommended to set up a reverse proxy in front of CODE, either you run CODE from Docker, or you use native packages. It is easy, and this way CODE can be reached on standard HTTP or HTTPS ports. We provide sample configuration files for Apache2 and Nginx. If you want SSL, we recommend certificates from Let’s Encrypt.
Now you can give https://collabora.example.com as the WOPI URL in your preferred File Sync and Share solution. See below for specific examples.
For more detailed and pretty instructions on integrating with various partner solutions please see (in alphabetical order):
- Nextcloud Setup Instructions (Apache & Nginx)
- ownCloud