An image proxy is used by Mattermost apps to prevent them from connecting directly to remote self-hosted servers. Configure an image proxy by going to System Console > Environment > Image Proxy, or by editing the config.json file as described in the following tables.

Enable image proxy#

Also available in legacy Mattermost Enterprise Edition E10 or E20

An image proxy anonymizes Mattermost app connections and prevents them from accessing insecure content.

  • true: (Default) Enables an image proxy for loading external images.

  • false: Disables the image proxy.

  • System Config path: Environment > Image Proxy

  • config.json setting: ".ImageProxySettings.Enable": true",

  • Environment variable: MM_IMAGEPROXYSETTINGS_ENABLE

See the image proxy documentation to learn more.

Image proxy type#

Also available in legacy Mattermost Enterprise Edition E10 or E20

The type of image proxy used by Mattermost.

  • local: (Default) The Mattermost server itself acts as the image proxy.

  • atmos/camo: An external atmos/camo image proxy is used.

  • System Config path: Environment > Image Proxy

  • config.json setting: ".ImageProxySettings.ImageProxyType": "local",

  • Environment variable: MM_IMAGEPROXYSETTINGS_IMAGEPROXYTYPE

See the image proxy documentation to learn more.

Remote image proxy URL#

Also available in legacy Mattermost Enterprise Edition E10 or E20

The URL of the atmos/camo proxy. This setting isn’t needed when using the local image proxy.

  • System Config path: Environment > Image Proxy

  • config.json setting: ".ImageProxySettings.RemoteImageProxyURL",

  • Environment variable: MM_IMAGEPROXYSETTINGS_REMOTEIMAGEPROXYURL

Remote image proxy options#

Also available in legacy Mattermost Enterprise Edition E10 or E20

The URL signing key passed to an atmos/camo image proxy. This setting isn’t needed when using the local image proxy type.

  • System Config path: Environment > Image Proxy

  • config.json setting: ".ImageProxySettings.RemoteImageProxyOptions",

  • Environment variable: MM_IMAGEPROXYSETTINGS_REMOTEIMAGEPROXYOPTIONS

See the image proxy documentation to learn more.