Administering the Atlassian Companion App
Confluence users can edit an attached file using its native desktop application, then automatically save the file back to Confluence.
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:
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.
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.
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. This means the 'Edit with' button won't appear when users open a file in preview.
To disable the edit files option in Confluence:
- Go to
- From the drop-down menu, select System.
- Click Confluence Previews from the displayed list.
- Click the enabled modules link.
- Hover on the Companion edit button module and click Disable.
Using terminal server environments
The Edit Files feature isn't compatible with terminal server environments (for example, Windows Remote Desktop Services) where each virtual desktop session shares the same network interface. This may be something we include in a future release. See Jira for more information:
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.