How to Set Up a Docker Container (Advanced)

If you have prior experience with setting up containers, here you may found the mere details on getting Sendent for Outlook running.

Pease replace <YOURDOMAIN> with your actual own domain, with included protocol. For example: <YOURDOMAIN> becomes https://outlook.sendent.dev.

Docker Compose file

Notice: Some extra environment variables might be applicable. This depends wether the installation is Microsoft Exchange On-Premise or Microsoft 365.

Please advice the following article and modify the docker compose file accordingly.

version: '3.9'
services:
  sendent.outlook:
    image: rg.nl-ams.scw.cloud/sendent-public/sendent-outlook:latest
    platform: linux/amd64
    build:
      context: .
      dockerfile: Dockerfile
    restart: on-failure
    environment:
      - BASE_URL=<YOURDOMAIN>
      - FEATURES_CODES_TO_REMOVE=
    ports:
      - "4300:4300"
    volumes:
      - ./docker-config:/usr/src/app/outlook-addin/docker-config
    networks:
      - node_network
 
networks:
  node_network:

Depending on the installation, you might want to remove certain features.

⚠️ Please consider these changes carefully
If you are a Microsoft 365 user, be aware that changing these settings is not instant. Updates are distributed centrally by Microsoft and can take up to 48 hours to take effect on all clients. We also recommend incrementing the <version> element in the manifest file, e.g. if we set 2.5.0, you increment it to 2.5.1 etc.

If you want to experiment with a limited setup first, use side-loading instead, this applies changes immediately and only affects your own client.

For "FEATURES_CODES_TO_REMOVE=" you can set the following values to remove certain buttons and events in the Outlook add-in:
0 = Remove Activity Tracker
1 = Remove Secure Mail
2 = Remove On-Send event actions
3 = Remove Nextcloud Talk Desktop
4 = Remove Nextcloud Talk Mobile
5 = Remove Nextcloud Files related features (upload files, public sharing)

Free users

We recommend the following default configuration.

BASE_URL=<YOURDOMAIN>
 
FEATURES_CODES_TO_REMOVE=0,1,2

Licensed users

We recommend the following default configuration.

<YOURNEXTCLOUDDOMAIN> should for example be https://nextcloud.sendent.dev.

Warning: we disabled on-send interaction in this example. You can re-enable it later again if you verified the installation works correctly, by simply removing the ‘2’ in FEATURES_CODES_TO_REMOVE and then re-upload your manifest file, if you uploaded the XML file manually. On-send interaction is needed if you want to automate uploading of attachments when the send button is clicked within Outlook.

BASE_URL=<YOURDOMAIN>
 
FEATURES_CODES_TO_REMOVE=2
 
DEFAULT_NEXTCLOUD_URL="<YOURNEXTCLOUDDOMAIN>"

Reverse proxy

Please ensure that either if NGINX or APACHE is used the maximum body size is increased.

NGINX: client_max_body_size 250M; (this sets the maximum file upload size to 250 MB).
APACHE: LimitRequestBody 262144000 (this sets the maximum file upload size to roughly 250 MB).