Administering the Atlassian Companion App

The Atlassian Companion app enables users to edit Confluence files in their preferred desktop application, then save the file back to Confluence automatically.

The download and re-upload of files is managed by the Atlassian Companion app, which needs to be installed on each user's machine (not in the Confluence installation directory) to enable file editing.

On this page:

Download and install the Atlassian Companion app

To edit files, users need to install the Atlassian Companion app and have it running in the background. The first time a user selects 'Edit with' in file preview, we prompt them to download and install the app. See Edit Files for details.

Screenshot: the download prompt shown in file preview








If your users aren't able to install applications themselves, you may want to distribute the app to them or deploy using the Microsoft Installer.

Download the latest version

Download the Atlassian Companion app for Mac or Windows.

Proxy and SSL considerations

When a user tries to edit an attached file, Confluence makes a DNS request to https://atlassian-domain-for-localhost-connections-only.com, which resolves to localhost (https://127.0.0.1). This allows Confluence to establish a secure WebSocket connection to the Companion app.

If your outgoing internet requests are filtered through a proxy server, you may need to exclude https://atlassian-domain-for-localhost-connections-only.com from the browser's forward proxies, otherwise the proxy server won't be able to route the request back to the local machine.

Install the Companion app via Microsoft Installer (MSI)

We also provide a Microsoft Installer package (.msi file) to deploy the Atlassian Companion app for Windows across multiple users or machines. By default, the Companion app installs to the Program Files directory, but you can customize this.

Download the Atlassian Companion MSI (69 MB)

If you deploy using the Microsoft Installer, the Companion app won’t automatically get the latest updates, including security and bug fixes, so some maintenance is required.

We may update the Companion app before or after we release a new version of Confluence. Check the Atlassian Companion app release notes to make sure you're on the latest version.

Disable file editing

System Administrators can remove the edit files option from their Confluence site.

To disable the edit files option when previewing a file:

  1. Go to 

    > Manage apps

  2. From the drop-down menu, select System.
  3. Click Confluence Previews from the displayed list.
  4. Click the enabled modules link.
  5. Hover on the Edit With plugin for the Media Viewer (companion-plugin) module, and click Disable.

To disable the edit option from the Attachments page, Attachments macro and View File macros:

  1. Go to 

    > Manage apps

  2. From the drop-down menu, select System.
  3. Click Confluence Previews from the displayed list.
  4. Click the enabled modules link.
  5. Hover on the Embedded 'Edit With' button (embedded-edit) module and click Disable.

Compatibility with virtual desktop environments

The Atlassian Companion app only works in some virtual desktop environments. If a user's environment isn't compatible with the Companion app, they won't be able to edit files in Confluence.

This table outlines which environments are compatible with the Companion app:

Environment Compatibility with Companion app

Virtual desktop infrastructure (VDI)
In this set up, each user gets their own VM (virtual machine), with a centralized service managing deployments.

(tick) Compatible

Session-based virtual desktops
Also referred to as Remote Desktop Service (RDS) or Remote Desktop Session Host (RDSH). In this set up, each user shares the same operating system (server).

(error) Not compatible

Virtual app streaming
Also referred to as Remote app publishing. This is where a single app runs on a remote server, but appears on the user's computer as if it were a local app.

(error) Not compatible

Recover edited files

When a user edits a file, that file is also downloaded and saved to the Atlassian Companion folder on their computer. Files are cleared every time the Companion app restarts.

Follow our guide to accessing Confluence files edited with the Atlassian Companion app.

Last modified on May 31, 2019

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.