In this guide we’ll run you through installing Confluence in a production environment, with an external database, using the Linux installer.
This is the most straightforward way to get your production site up and running on a Linux server.
Other ways to install Confluence:
Evaluation — get your free trial up and running in no time.
TAR.GZ – install Confluence manually from an archive file.
Windows – install Confluence on a Windows server.
On this page:
Before you begin
Before you install Confluence, there are a few questions you need to answer.
Are you using a supported operating system?
Check the Supported Platforms page for the version of Confluence you are installing. This will give you info on supported operating systems, databases and browsers.
Good to know:
We don’t support installing Confluence on OSX for production sites.
The Confluence installer includes Java (JRE) and Tomcat, so you don’t need to install these separately.
Confluence can only run on Oracle JDK or AdoptOpenJDK.
Does your Linux server have a font config package installed?
Many Linux distributions don’t include a suitable font config package by default, so you will need to install one before you can run the Confluence installer.
Do you want to run Confluence as a service?
Running Confluence as a service means that Confluence will automatically start up when Linux is started.
If you choose to run Confluence as a service:
You must use sudo to run the installer to be able to install Confluence as a service.
The installer will create a dedicated user account, confluence , that will run the service.
If you choose not to run Confluence as a service:
You will start and stop Confluence by running the start-confluence.sh file in your Confluence installation directory.
Confluence will be run as the user account that was used to install Confluence, or you can choose to run as a dedicated user.
Confluence will need to be restarted manually if your server is restarted.
Are ports 8090 and 8091 available?
Synchrony, which is required for collaborative editing, runs on port 8091 by default. If this port is already in use, you will need to change the port that Synchrony runs on after your Confluence installation is complete. See Administering Collaborative Editing to find out how to change the port Synchrony runs on. You won’t be able to edit pages until Synchrony has an available port.
See Ports used by Atlassian Applications for a summary of all the ports used.
Is your database set up and ready to use?
Good to know:
Set up your database before you begin. Step-by-step guides are available for PostgreSQL, Oracle, MySQL, and SQL Server.
If you’re using Oracle or MySQL you’ll need to download the driver for your database.
To use a datasource see Configuring a datasource connection as there are some steps you need to perform before running the setup wizard.
Do you have a Confluence license?
Good to know:
If you have not yet purchased a Confluence license you’ll be able to create an evaluation license during setup.
If you already have a license key you’ll be prompted to log in to my.atlassian.com to retrieve it, or you can enter the key manually during setup.
If you’re migrating from Confluence Cloud, you’ll need a new license.
There’s a known issue during setup where a load balancer (or proxy) pings the server and breaks Confluence installation or migration to Data Center. See CONFSERVER-61189 — Getting issue details. STATUS During installation, you need to disable load balancer health checks and make sure you don’t open multiple tabs that point to the same Confluence URL.
Install Confluence
1. Download Confluence
2. Run the installer
Make the installer executable.
Change to the directory where you downloaded Confluence then execute this command:
Where X.X.X is is the Confluence version you downloaded.
Run the installer – we recommend using sudo to run the installer as this will create a dedicated account to run Confluence and allow you to run Confluence as a service.
To use sudo to run the installer execute this command:
Where X.X.X is is the Confluence version you downloaded.
You can also choose to run the installer as with root user privileges.
If you’re installing Confluence on a fresh Linux installation see Confluence throws a Confluence is vacant error on install for troubleshooting options.
FontConfiguration error? See Confluence Server 6.13 or later fails with FontConfiguration error when installing on Linux operating systems to find out how to install a suitable font configuration package.
Set up Confluence
3. Choose installation type
Choose Production installation.
Choose any apps you’d also like to install.
4. Enter your license
5. Connect to your database
If you’ve not already done so, it’s time to create your database. See the ‘Before you begin’ section of this page for details and connection options.
For MySQL and Oracle, follow the prompts to download and install the required driver.
Enter your database details. Use test connection to check your database is set up correctly.
If you want to specify particular parameters, you can choose to connect By connection string. You’ll be prompted to enter:
Database URL – the JDBC URL for your database. If you’re not sure, check the documentation for your database.
Username and Password – A valid username and password that Confluence can use to access your database.
6. Populate your new site with content
This option will create a space that you and your users can use to get to know Confluence. You can delete this space at any time.
Use this option if you have a full site export of an existing Confluence site. This is useful when you’re migrating to another database or setting up a test site.
Good to know:
You can only import sites from the same or earlier Confluence version.
The system administrator account and all other user data and content will be imported from your previous installation.
In the setup wizard:
Upload a backup file – use this option if your site export file is small (25mb or less).
Restore a backup file from the file system – use this option if your backup file is large. Drop the file into your /restore directory then follow the prompts to restore the backup.
Build Index – we’ll need to build an index before your imported content is searchable. This can take a long time for large sites, so deselect this option if you would rather build the index later. Your content won’t be searchable until the index is built.
7. Choose where to manage users
Choose this option if you’re happy to manage users in Confluence, or don’t have a Jira application installed.
Good to know:
If you do plan to manage users in a Jira application, but have not yet installed it, we recommend installing Jira first, and then returning to the Confluence setup.
You can add external user management (for example LDAP, Crowd or Jira) later if you choose.
Choose this option if you have a Jira application installed and want to manage users across both applications.
Good to know:
This is a quick way of setting up your Jira integration with the most common options.
It will configure a Jira user directory for Confluence, and set up application links between Jira and Confluence for easy sharing of data.
You’ll be able to specify exactly which groups in your Jira app should also be allowed to log in to Confluence. Your license tiers do not need to be the same for each application.
You’ll need either Jira 4.3 or later, Jira Core 7.0 or later, Jira Software 7.0 or later, or Jira Service Management 3.0 or later.
In the setup wizard:
Jira Base URL – the address of your Jira server, such as http://www.example.com:8080/jira/ or http://jira.example.com/
Jira Administrator Login – this is the username and password of a user account that has the Jira System Administrator global permission in your Jira application. Confluence will also use this username and password to create a local administrator account which will let you access Confluence if Jira is unavailable. Note that this single account is stored in Confluence’s internal user directory, so if you change the password in Jira, it will not automatically update in Confluence.
Confluence Base URL – this is the URL Jira will use to access your Confluence server. The URL you give here overrides the base URL specified in Confluence, for the purposes of connecting to the Jira application.
User Groups – these are the Jira groups whose members should be allowed to use Confluence. Members of these groups will get the ‘Can use’ permission for Confluence, and will be counted in your Confluence license. The default user group name differs depending on your Jira version:
Jira 6.4 and earlier: jira-users .
Jira Software 7.x and later: jira-software-users
Jira Core 7.x and later: jira-core-users
Jira Service Management (formerly Jira Service Desk) 3.x and later: jira-servicedesk-users
Admin Groups – provide one or more Jira groups whose members should have administrative access to Confluence. The default group is jira-administrators . These groups will get the system administrator and Confluence administrator global permissions in Confluence.
8. Create your administrator account
Enter details for the administrator account.
Skip this step if you chose to manage users in a Jira application or you imported data from an existing site.
9. Start using Confluence
If you plan to run Confluence behind a reverse proxy, check out Proxy and SSL considerations before you go any further.
Here’s a few things that will help you get your team up and running:
Set the server base URL – this is the URL people will use to access Confluence.
Set up a mail server – this allows Confluence to send people notification about content.
Add and invite users – get your team on board!
Start and stop Confluence – find out how to start and stop Confluence.
Troubleshooting
If the installer fails with a FontConfiguration error, you’ll need to install a font package. See Confluence Server 6.13 or later fails with FontConfiguration error when installing on Linux operating systems for info on how to do this.
Some anti-virus or other Internet security tools may interfere with the Confluence installation process and prevent the process from completing successfully. If you experience or anticipate experiencing such an issue with your anti-virus/Internet security tool, disable this tool first before proceeding with the Confluence installation.
The Linux OOM Killer can sometimes kill Confluence processes when memory on the server becomes too low. See How to Configure the Linux Out-of-Memory Killer.
Collaborative editing errors? See Troubleshooting Collaborative Editing.
Head to Installation Troubleshooting in our Knowledge Base for more help.
Источник
Confluence Support
Knowledge base
Products
Jira Software
Project and issue tracking
Jira Service Management
Service management and customer support
Jira Core
Manage any business project
Confluence
Bitbucket
Git code management
Resources
Documentation
Usage and admin help
Community
Answers, support, and inspiration
Suggestions and bugs
Feature suggestions and bug reports
Marketplace
Billing and licensing
Frequently asked questions
Viewport
Confluence
Versions
Installing Confluence on Linux
Installing Confluence
On this page
In this section
Related content
Still need help?
The Atlassian Community is here for you.
In this guide we’ll run you through installing Confluence in a production environment, with an external database, using the Linux installer.
This is the most straightforward way to get your production site up and running on a Linux server.
Other ways to install Confluence:
Evaluation — get your free trial up and running in no time.
TAR.GZ – install Confluence manually from an archive file.
Windows – install Confluence on a Windows server.
On this page:
Before you begin
Before you install Confluence, there are a few questions you need to answer.
Are you using a supported operating system?
Check the Supported Platforms page for the version of Confluence you are installing. This will give you info on supported operating systems, databases and browsers.
Good to know:
We don’t support installing Confluence on OSX for production sites.
The Confluence installer includes Java (JRE) and Tomcat, so you don’t need to install these separately.
Confluence can only run on Oracle JDK or AdoptOpenJDK.
Does your Linux server have a font config package installed?
Many Linux distributions don’t include a suitable font config package by default, so you will need to install one before you can run the Confluence installer.
Do you want to run Confluence as a service?
Running Confluence as a service means that Confluence will automatically start up when Linux is started.
If you choose to run Confluence as a service:
You must use sudo to run the installer to be able to install Confluence as a service.
The installer will create a dedicated user account, confluence , that will run the service.
If you choose not to run Confluence as a service:
You will start and stop Confluence by running the start-confluence.sh file in your Confluence installation directory.
Confluence will be run as the user account that was used to install Confluence, or you can choose to run as a dedicated user.
Confluence will need to be restarted manually if your server is restarted.
Are ports 8090 and 8091 available?
Synchrony, which is required for collaborative editing, runs on port 8091 by default. If this port is already in use, you will need to change the port that Synchrony runs on after your Confluence installation is complete. See Administering Collaborative Editing to find out how to change the port Synchrony runs on. You won’t be able to edit pages until Synchrony has an available port.
See Ports used by Atlassian Applications for a summary of all the ports used.
Is your database set up and ready to use?
Good to know:
Set up your database before you begin. Step-by-step guides are available for PostgreSQL, Oracle, MySQL, and SQL Server.
If you’re using Oracle or MySQL you’ll need to download the driver for your database.
To use a datasource see Configuring a datasource connection as there are some steps you need to perform before running the setup wizard.
Do you have a Confluence license?
Good to know:
If you have not yet purchased a Confluence license you’ll be able to create an evaluation license during setup.
If you already have a license key you’ll be prompted to log in to my.atlassian.com to retrieve it, or you can enter the key manually during setup.
If you’re migrating from Confluence Cloud, you’ll need a new license.
There’s a known issue during setup where a load balancer (or proxy) pings the server and breaks Confluence installation or migration to Data Center. See CONFSERVER-61189 — Getting issue details. STATUS During installation, you need to disable load balancer health checks and make sure you don’t open multiple tabs that point to the same Confluence URL.
Install Confluence
1. Download Confluence
2. Run the installer
Make the installer executable.
Change to the directory where you downloaded Confluence then execute this command:
Where X.X.X is is the Confluence version you downloaded.
Run the installer – we recommend using sudo to run the installer as this will create a dedicated account to run Confluence and allow you to run Confluence as a service.
To use sudo to run the installer execute this command:
Where X.X.X is is the Confluence version you downloaded.
You can also choose to run the installer as with root user privileges.
If you’re installing Confluence on a fresh Linux installation see Confluence throws a Confluence is vacant error on install for troubleshooting options.
FontConfiguration error? See Confluence Server 6.13 or later fails with FontConfiguration error when installing on Linux operating systems to find out how to install a suitable font configuration package.
Set up Confluence
3. Choose installation type
Choose Production installation.
Choose any apps you’d also like to install.
4. Enter your license
5. Connect to your database
If you’ve not already done so, it’s time to create your database. See the ‘Before you begin’ section of this page for details and connection options.
For MySQL and Oracle, follow the prompts to download and install the required driver.
Enter your database details. Use test connection to check your database is set up correctly.
If you want to specify particular parameters, you can choose to connect By connection string. You’ll be prompted to enter:
Database URL – the JDBC URL for your database. If you’re not sure, check the documentation for your database.
Username and Password – A valid username and password that Confluence can use to access your database.
6. Populate your new site with content
This option will create a space that you and your users can use to get to know Confluence. You can delete this space at any time.
Use this option if you have a full site export of an existing Confluence site. This is useful when you’re migrating to another database or setting up a test site.
Good to know:
You can only import sites from the same or earlier Confluence version.
The system administrator account and all other user data and content will be imported from your previous installation.
In the setup wizard:
Upload a backup file – use this option if your site export file is small (25mb or less).
Restore a backup file from the file system – use this option if your backup file is large. Drop the file into your /restore directory then follow the prompts to restore the backup.
Build Index – we’ll need to build an index before your imported content is searchable. This can take a long time for large sites, so deselect this option if you would rather build the index later. Your content won’t be searchable until the index is built.
7. Choose where to manage users
Choose this option if you’re happy to manage users in Confluence, or don’t have a Jira application installed.
Good to know:
If you do plan to manage users in a Jira application, but have not yet installed it, we recommend installing Jira first, and then returning to the Confluence setup.
You can add external user management (for example LDAP, Crowd or Jira) later if you choose.
Choose this option if you have a Jira application installed and want to manage users across both applications.
Good to know:
This is a quick way of setting up your Jira integration with the most common options.
It will configure a Jira user directory for Confluence, and set up application links between Jira and Confluence for easy sharing of data.
You’ll be able to specify exactly which groups in your Jira app should also be allowed to log in to Confluence. Your license tiers do not need to be the same for each application.
You’ll need either Jira 4.3 or later, Jira Core 7.0 or later, Jira Software 7.0 or later, or Jira Service Management 3.0 or later.
In the setup wizard:
Jira Base URL – the address of your Jira server, such as http://www.example.com:8080/jira/ or http://jira.example.com/
Jira Administrator Login – this is the username and password of a user account that has the Jira System Administrator global permission in your Jira application. Confluence will also use this username and password to create a local administrator account which will let you access Confluence if Jira is unavailable. Note that this single account is stored in Confluence’s internal user directory, so if you change the password in Jira, it will not automatically update in Confluence.
Confluence Base URL – this is the URL Jira will use to access your Confluence server. The URL you give here overrides the base URL specified in Confluence, for the purposes of connecting to the Jira application.
User Groups – these are the Jira groups whose members should be allowed to use Confluence. Members of these groups will get the ‘Can use’ permission for Confluence, and will be counted in your Confluence license. The default user group name differs depending on your Jira version:
Jira 6.4 and earlier: jira-users .
Jira Software 7.x and later: jira-software-users
Jira Core 7.x and later: jira-core-users
Jira Service Management (formerly Jira Service Desk) 3.x and later: jira-servicedesk-users
Admin Groups – provide one or more Jira groups whose members should have administrative access to Confluence. The default group is jira-administrators . These groups will get the system administrator and Confluence administrator global permissions in Confluence.
8. Create your administrator account
Enter details for the administrator account.
Skip this step if you chose to manage users in a Jira application or you imported data from an existing site.
9. Start using Confluence
If you plan to run Confluence behind a reverse proxy, check out Proxy and SSL considerations before you go any further.
Here’s a few things that will help you get your team up and running:
Set the server base URL – this is the URL people will use to access Confluence.
Set up a mail server – this allows Confluence to send people notification about content.
Add and invite users – get your team on board!
Start and stop Confluence – find out how to start and stop Confluence.
Troubleshooting
If the installer fails with a FontConfiguration error, you’ll need to install a font package. See Confluence Server 6.13 or later fails with FontConfiguration error when installing on Linux operating systems for info on how to do this.
Some anti-virus or other Internet security tools may interfere with the Confluence installation process and prevent the process from completing successfully. If you experience or anticipate experiencing such an issue with your anti-virus/Internet security tool, disable this tool first before proceeding with the Confluence installation.
The Linux OOM Killer can sometimes kill Confluence processes when memory on the server becomes too low. See How to Configure the Linux Out-of-Memory Killer.
Collaborative editing errors? See Troubleshooting Collaborative Editing.
Head to Installation Troubleshooting in our Knowledge Base for more help.
