Go to the top of this page is here Go to the body of content

1 System requirements

Backlog is a web application and requires a server to run it. In addition, you need a web browser to use Backlog.

1.1 Server requirements

Server requirements to run Backlog Enterprise (Version 1.10.12) are as follows:

1.1.1 Hardware

CPU 2.5 GHz or more
Memory 2.5 GB or more
Hard disk 30 GB or more (depending on the amount of data - files, repository size - you'll need to store)

1.1.2 OS

Backlog is compatible with the following operating systems (OS):

  • Red Hat Enterprise Linux 7
  • Red Hat Enterprise Linux 6 server / the i386 version (32bit version) or the x86_64 version (64bit version)
  • CentOS 7
  • CentOS 6 / the i386 version (32bit version) or the x86_64 version (64bit version)

Setting the time zone (optional).

  • For Red Hat Enterprise Linux 7 or CentOS 7
    # timedatectl set-timezone Asia/Tokyo

Ensure that all other middleware (e.g. database server and SMTP server) are running in the time zone of your choice as well.

1.1.3 Java

Backlog works with the following Javas:

  • OpenJDK 8 latest version (Installed from yum repository distributed by Red Hat)
  • OracleJDK 8 latest version (Installed in RPM format distributed by Oracle)

1.1.4 Database

Backlog works with the following databases:

  • PostgreSQL 9.4 ( Final Release will be February 13, 2020 )
  • PostgreSQL 9.5 ( Final Release will be February 11, 2021 )
  • PostgreSQL 9.6 ( Final Release will be November 11, 2021 )
  • MySQL 5.6 ( Extended Support will end Feb 2021 )
  • MySQL 5.7 ( Extended Support will end Oct 2023 )

Check the Versioning Policy for more information about PostgreSQL's EOL.
Check Oracle Lifetime Support Policy: Coverage for Technology Products (pdf, p.21 for MySQL) for more information about MySQL's EOL.

Backlog planning to stop PostgreSQL support. The final supported version of PostgreSQL is version 9.6.
We recommend MySQL in the future for Backlog servers.

1.1.5 SMTP server

You'll need an SMTP server that can send mail without SMTP authentication.
You can use Sendmail and Postfix, which are installed by default on Red Hat Enterprise Linux or CentOS.

1.1.6 Active Directory server

To use Active Directory for user authentication in Backlog, you'll need a server. (New function from 1.5.0)
Backlog finds and connects to the Active Directory server via the DNS SRV resource, then records and authenticates the user.
The Zone definition for Active Directory - and setting the SRV resource record - are both required beforehand.
This corresponds to Active Directory on Windows Server 2008, Windows Server 2012 R2, and Windows Server 2016.

1.2 Web browser requirements

Web browsers suitable for using Backlog are as follows.

1.2.1 For Windows 7 / Windows 8 / Windows 10

  • Internet Explorer 11 (Backlog won't display correctly in "Compatibility Mode" - disable it!)
  • Microsoft Edge
  • Mozilla Firefox, latest version
  • Google Chrome, latest version

1.2.2 For macOS (aka Mac OSX)

  • Apple Safari, latest version
  • Mozilla Firefox, latest version
  • Google Chrome, latest version

Note: While other browsers may work with Backlog, we do not officially support them.

2 Java font settings (optional)

To display Japanese in images such as burndown charts generated by Backlog, the Java font setting must be configured.
To learn how to do this, follow the steps below:

2.1 Font installation

Install the Japanese font package with the following commands.
If it's already installed, skip this step.

# yum install ipa-pgothic-fonts

2.2 Linking font to Java installation directory

Follow the steps below to link the installed fonts. Here, the JAVA_HOME environment variable is the Java installation directory. (Example: /usr/java/default)

# mkdir -p $JAVA_HOME/jre/lib/fonts/fallback
# ln -s /usr/share/fonts/ipa-pgothic/ipagp.ttf $JAVA_HOME/jre/lib/fonts/fallback/

3 Installing additional packages

To use Backlog Enterprise 1.10.12, install the following dependencies:
(If already installed, skip this step.)

3.1 Installation of git

The version of git that comes installed by default with yum is NOT the latest version, and has known vulnerabilities. If you already installed git via yum, we strongly recommend that you update to the latest version (and delete the old version).
# yum remove git
Install the latest version of git from source using the commands below. git 2.19.2 is the latest version at the current time of writing, Dec 4, 2018.
# yum install curl-devel expat-devel gettext-devel openssl-devel zlib-devel perl-ExtUtils-MakeMaker
$ wget https://www.kernel.org/pub/software/scm/git/git-2.19.2.tar.gz
$ tar -zxf git-2.19.2.tar.gz
$ cd git-2.19.2
$ make configure
$ ./configure --prefix=/usr
$ make
$ sudo make install
$ git --version

3.2 Installing bind-utils

Since bind-utils is not installed by default, install it with the following command:
# yum install bind-utils

3.3 Installing libraries

Install these packages with the following command.
# yum install libpng giflib libjpeg perl-version

3.4 Installing bzip2

For Red Hat Enterprise Linux 7 or CentOS 7, bzip2 may not be installed by default. If it is not, please install it with the following command.
# yum install bzip2

4 Installation

Follow the steps below to install Backlog.

  • Download the Backlog package (RPM file).
  • Download and install the database driver.
  • Create a database.
  • Install RPM
  • Launch the configuration tool.
  • Answer the questions and proceed through the prompts in the configuration tool.
  • Done.

4.1 Downloading Backlog package archive

Backlog Enterprise RPM packages are on the page https://backlog.com/enterprise/download

Backlog RPM packages can be downloaded. There are four RPM files to download, the specific RPM file differs depending on your OS.

4.1.1 For Red Hat Enterprise Linux 6 server or CentOS 6 (i386)

  • backlog-app-1.10.12-01.el6.noarch.rpm
  • backlog-www-1.10.11-01.el6.i386.rpm
  • backlog-git-1.10.12-01.el6.i386.rpm
  • backlog-api-1.10.11-01.el6.noarch.rpm

4.1.2 For Red Hat Enterprise Linux 6 server or CentOS 6 (x86_64)

  • backlog-app-1.10.12-01.el6.noarch.rpm
  • backlog-www-1.10.11-01.el6.x86_64.rpm
  • backlog-git-1.10.12-01.el6.x86_64.rpm
  • backlog-api-1.10.11-01.el6.noarch.rpm

4.1.3 For Red Hat Enterprise Linux 7 or CentOS 7

  • backlog-app-1.10.12-01.el7.noarch.rpm
  • backlog-www-1.10.11-01.el7.x86_64.rpm
  • backlog-git-1.10.12-01.el7.x86_64.rpm
  • backlog-api-1.10.11-01.el7.noarch.rpm

4.2 Downloading and installing database driver

Backlog uses database drivers for the Java and Perl programming languages. Depending on your database, please do the following.

4.2.1 For MySQL

  • MySQL database driver for Java language

    You need to download the database driver for Java language. Download the latest version of "Platform Independent (Architecture Independent), Compressed TAR Archive" from the download site of the following URL and decompress it.

    Please make sure you are using version 5.1, as Backlog is not compatible with version 8.


    Copy "mysql-connector-java-5.1.X-bin.jar" of the extracted file to the directory where you downloaded the Backlog package.

    • Example (when installing with /tmp/backlog)
    # tar zxfv mysql-connector-java-5.1.42.tar.gz
    # cp mysql-connector-java-5.1.42/mysql-connector-java-5.1.42-bin.jar /tmp/backlog/
  • • MySQL database driver for Perl language

    Install the "perl-DBD-MySQL" package (or its update) included with the OS.

    • Example
    # yum install perl-DBD-MySQL

4.2.2 For PostgreSQL

  • PostgreSQL database driver for Java language

    The database driver for Java language is included with Backlog, so no further action is needed for it.

  • PostgreSQL database driver for Perl language

    Install the "perl-DBD-Pg" package (or its update) included with the OS.

    • Example
    # yum install perl-DBD-Pg

4.3 Setting up database (MySQL only)

4.3.1 max_allowed_packet

Backlog stores issues and wiki attachments in the database.
For MySQL, it is necessary to set max_allowed_packet to be able to register large size data.
Add the following settings to my.cnf and start up MySQL server.

max_allowed_packet = 16M

4.3.2 InnoDB

Backlog tables assume that InnoDB is used and enabled; they will not work properly unless InnoDB is enabled. After starting MySQL, check if InnoDB is enabled, and if it is not, check the settings and installation.

4.3.3 default-character-set

Please specify UTF-8 as character encoding of the database. Add the following settings to my.cnf and start up MySQL server.


4.3.4 sql_mode (only for MySQL 5.7)

If you are using MySQL 5.7, please add the following settings to my.cnf and start up MySQL server.


4.4 Creating database

By default, Backlog connects to the database with the following settings.

Database setting
Database name backlog
Database user name backlog
Database password Backlog@1

Username and password can be changed at the time of configuration. Create database users beforehand.

Please do not use the dollar sign character ($) in this password as it may cause issues in Backlog.

  • Example for PostgreSQL
    # createuser -S -d -R -P backlog
  • MySQL example
    # mysql -u root -p
    mysql> GRANT ALL PRIVILEGES ON *.* TO 'backlog'@'localhost' IDENTIFIED BY 'Backlog@1' WITH GRANT OPTION;

Create a database to use for Backlog (as shown below).

  • Example for PostgreSQL (Please specify "UTF-8" for database encoding)
    # createdb -U backlog -E UTF8 backlog
  • MySQL example
    # mysqladmin -u backlog -p create backlog

4.5 Installing RPM

Install the Backlog package with the following command:

  • For Red Hat Enterprise Linux 6 server or CentOS 6 (i386)
    # rpm -ivh \
      backlog-app-1.10.12-01.el6.noarch.rpm \
      backlog-www-1.10.11-01.el6.i386.rpm \
      backlog-git-1.10.12-01.el6.i386.rpm \
  • For Red Hat Enterprise Linux 6 server or CentOS 6 (x86_64)
    # rpm -ivh \
      backlog-app-1.10.12-01.el6.noarch.rpm \
      backlog-www-1.10.11-01.el6.x86_64.rpm \
      backlog-git-1.10.12-01.el6.x86_64.rpm \
  • For Red Hat Enterprise Linux 7 or CentOS 7
    # rpm -ivh \
      backlog-app-1.10.12-01.el7.noarch.rpm \
      backlog-www-1.10.11-01.el7.x86_64.rpm \
      backlog-git-1.10.12-01.el7.x86_64.rpm \

4.6 Starting configuration tool

Use the configuration tool enclosed in the Backlog package (backlog-app) to configure the environment for Backlog.
Execute the following command to start the configuration tool.

# /opt/backlog/bin/init.sh
   Backlog Enterprise Configurater
   ____             _    _
   |  _ \           | |  | |
   | |_) | __ _  ___| | _| | ___   __ _
   |  _ < / _` |/ __| |/ / |/ _ \ / _` |
   | |_) | (_| | (__|   <| | (_) | (_| |
   |____/ \__,_|\___|_|\_\_|\___/ \__, |
                                   __/ |


Starting configuration of Backlog Enterprise.

When the start title is shown, configuration has begun.
Throughout the installer, the values shown in the brackets [] represent the default values that will be used if you another value is not entered.

Set the URL to access Backlog[http://localhost:8969]
(/backlog is added as the context path to the set URL)

Specify the URL where Backlog can be referred on the web browser.
This will be the base of the URL included in the emails that will be sent when you make changes to issues.

Example) If you specify http://example.com:8969, it will be described as http://example.com:8969/backlog/ISSUE-01 in the notification email for the issue named "ISSUE-01".

In addition, when you access the mobile version, you may need to specify 80 or 443 (if https) as the port number. (In case of using DoCoMo etc.)

Specify host name of SMTP server [localhost]

Specify the host name of SMTP server to use when sending emails. (Authentication formats such as POP before SMTP and SMTP-AUTH are not supported)

Select the database you'd like to use
( m<MySQL> / p<PostgreSQL> )

Select the database to use with Backlog.
Next, specify the "Database server host name", "Database server port number", "Database server access user name", and "Database server access password".

Performing startup setting with the following settings.
Backlog URL       [http://example.com:8969]
SMTP server host  [localhost]
Database      [PostgreSQL]
  Server host        [localhost]
  Port number      [5432]
  User          [backlog]
  Password      [backlog]

Is this OK?
( y<Continue> / r<Redo> ) 
  • Select "y<Continue>" to connect to the database and create a table.
  • If you select "r<Redo>", retry from specifying the URL to access Backlog while keeping the current setting value.
  • If your database is MySQL, select JDBC driver.
Select JDBC driver to use.

As the selection target, display mysql-connector-java-XXX.jar placed in the current directory in which the configuration tool was started.

After database connection verification has finished, the initial table of Backlog will be created. (If you have already created it, you can skip the creation process.)

Starting to create a new table.
A new table has been created.

Setting is completed.

After confirming starting up of Backlog, please continue to connect to http://example.com:8969/backlog/Setup.action and register user information.

A completion message is displayed, and Backlog configuration is completed!
Backlog will start up.
You can access the URL displayed in the installation completion message from the web browser and register the initial setting and user information.

5 Initial setting

When the configuration is completed, it's necessary to perform initial setting first. At the initial setting, please register your license key and administrator information.

First, ensure that Backlog is running, then access the following URL for initial setup.

[Access URL to Backlog server specified in configuration]/backlog/Setup.action (Example: http://localhost:8969/backlog/Setup.action )

5.1 Entering space information

Here, please enter your Backlog space name and license key. "Space name" is the name of of the space displayed at the top of login screen and dashboard. "Space URL" is used to create a URL described in an issue email etc.
Please be sure to read Nulab terms of use, then check "I accept the terms of use".

5.2 Entering administrator information

Here, please enter the information of an administrator user (space owner).
Space owners are users who can use the following functions in addition to the functions of standard administrators. (For details on functions, please refer to the space owner guide)

  • Edit access restrictions
  • Change license key
  • Change space owner

NOTE: It's important to set the administrator user properly. Double-check everything to make sure it's correct.

5.3 Completing initial setting

Verify that the setting contents and license information are entered correctly.

When this screen is displayed, the initial setting is completed. It will automatically move to Backlog top page (dashboard).

NOTE: The space owner will receive an email indicating that the initial configuration has completed - be sure to check it!
The URL of Backlog becomes as follows:
[Access URL to Backlog server specified in configuration]/backlog (Example: http://example.com:8969/backlog/)

6 After completing installation and initial configuration:

  • First, let's add projects and users.
  • The Backlog URL and log-in information are notified to added users by email.
  • Once a project is created, add milestones and categories.
  • For more details of functions, always refer to "Help" displayed on the upper left of the screen.
  • Check the operation guide for more information.
  • You can migrate your projects from Redmine to Backlog. Check the guide for more information.
  • You can migrate your projects from JIRA to Backlog. Check the guide for more information.
  • Linux is a registered trademark or trademark of Mr. Linus Torvalds in Japan and other countries.
  • Red Hat is a registered trademark or trademark of Red Hat, Inc. in the United States and other countries.
  • MySQL and Java are registered trademarks of Oracle Corporation and its subsidiaries and affiliates in the United States and other countries. Company names, product names, etc. in the text may be trademarks or registered trademarks of each company.
  • Other company names and product names mentioned are registered trademarks or trademarks of each company.

Author: Backlog Support <support@backlog.com>

Date: 2020-02-05 15:00:00 JST