Skip to main content

Backlog Enterprise Installation Guide

Version 2.3.0

Introduction

This guide explains how to install Backlog Enterprise V2 using Docker. Before starting the installation, make sure that the server and associated software meet system requirements.
Already using Backlog Enterprise V1? Get V2 with our Backlog Enterprise Upgrade Guide.

System requirements

Server

Hardware

Requirements
Memory16 GB
Hard disk30GB
Increase this depending on the amount of data, files, repository size, etc. you want to store in Backlog.
CPU2.4 GHz, 4 core

OS

OS supported by Docker
(https://docs.docker.com/engine/install/)

Software

AWS CLI (Command Line Interface)

version 2.x

Docker

version 20.10.0 or higher

Middleware

Database

MySQL 5.7
MySQL 8.0

SMTP server

An SMTP server that can send mail without SMTP authentication

Service usage requirements

Web browser

  • Windows
    • Microsoft Edge (latest version available)
    • Mozilla Firefox (latest version available)
    • Google Chrome (latest version available)
  • Mac OSX
    • Apple Safari (latest version available)
    • Mozilla Firefox (latest version available)
    • Google Chrome (latest version available)

Work procedure

Advance preparation

Prepare everything before starting your installation. Below, we’ll walk through an installation using Linux as an example.

Preparing SSL certificate

Backlog uses HTTPS. You’ll need:

  • SSL certificate
  • Private key file

Installing AWS CLI

Download the AWS CLI installer, and install.

curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip"
unzip awscliv2.zip
sudo ./aws/install

For more information on installing the AWS CLI, refer to the official AWS guide.

Installing Docker

Set up the yum repository, and install Docker.

sudo yum install -y yum-utils
sudo yum-config-manager \
    --add-repo \
    https://download.docker.com/linux/centos/docker-ce.repo
sudo yum install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

Set Docker to start up automatically.

sudo systemctl enable docker

Start up Docker.

sudo systemctl start docker

Install Docker Compose.

sudo curl -L https://github.com/docker/compose/releases/download/v2.18.1/docker-compose-linux-x86_64 -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose

For more information on installing Docker:

Preparing database (MySQL)

Prepare a database (MySQL) to store the Backlog data. IaaS, such as Amazon RDS, is available, and MySQL can be installed on any server including the one where Backlog is installed.

Add the following settings to my.cnf:

For MySQL 8.0
[mysqld]
sql_mode="NO_ENGINE_SUBSTITUTION"
default_authentication_plugin=mysql_native_password
For MySQL 5.7
[mysqld]
max_allowed_packet = 16M
character-set-server=utf8mb4
sql_mode = "NO_ENGINE_SUBSTITUTION"

[mysql]
default-character-set=utf8mb4

[client]
default-character-set=utf8mb4

Preparing SMTP server

Prepare an SMTP server to send emails from Backlog. SMTP servers installed by default on Red Hat Enterprise Linux and CentOS, such as Sendmail and Postfix, can send email without SMTP authentication.

Installation

  1. Creating a database
  2. Placing the SSL certificate
  3. Running the configuration tool
  4. Migrating a database
  5. Starting Backlog

Setting up the operating environment

Creating a database

Create a database name and user for Backlog. We recommend:

Namebacklog
Userbacklog
Placing the SSL certificate

Place the SSL certificate and prepared private key file to any directory on the Backlog server.

mkdir “any directory”
cp “the SSL certificate” “the any directory”/crt.pem
cp “the private key file” “the any directory”/key.pem

Running the configuration tool

Download a Docker image of the configuration tool. Set AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY as environment variables copied from the Enterprise Account page.

export AWS_ACCESS_KEY_ID="XXXX"
export AWS_SECRET_ACCESS_KEY="XXXX"

Log in to Docker.

aws ecr get-login-password --region ap-northeast-1 | docker login --username AWS --password-stdin 019623933850.dkr.ecr.ap-northeast-1.amazonaws.com

Then, run the configuration tool under a directory where Backlog will be installed.
For example, if the installation directory is backlog-enterprise:

mkdir backlog-enterprise
cd backlog-enterprise
docker run --rm -it -v $PWD:/work -v $PWD/data:/data 019623933850.dkr.ecr.ap-northeast-1.amazonaws.com/enterprise-bootstrap:2.3.0

The configuration is interactive. There are eight items to complete, and they should be done according to the environment in which Backlog will function.

Please enter the host name of your database server.
[e.g.] backlog-db.example.com, 192.168.0.11
>

If your database is running on the server where Backlog is installed, enter 10.254.249.1 instead of localhost or 127.0.0.1.

Please enter the name of Backlog's database.
Default value: backlog
> backlog

Please enter the user name for connecting to the database.
Default value: backlog
> backlog

Please enter the password for connecting to the database.
>

Enter the database information created earlier.

Please enter your SMTP host name for sending email. Environment variables are also available.
[e.g.] backlog-smtp.example.com, 192.168.0.12
> 

Enter the SMTP server information created earlier. If your SMTP server is running on the server where Backlog is installed, enter 10.254.249.1 instead of localhost or 127.0.0.1.

Please enter your time zone name.
[e.g.] Asia/Tokyo, America/New_York, Europe/London
> 

Ensure the time zone name matches the time zones of other middleware such as a database server and an SMTP server.

Please enter the directory containing the SSL certificate.
> 

Enter the “absolute” directory path created earlier.

Your installation is now complete.

Migrating a database

Create database tables, etc., with the following command:

docker-compose up -d database-migration

Starting Backlog

Start Backlog with the following command:

docker-compose up -d

If you need to stop Backlog, use the following command:

docker-compose down

Initial setup

Register your license key and administrator information at the following:
https://[host name]/backlog/Setup.action

Read and accept the Terms of Service to continue.

Entering space information

Enter your Backlog space name, space URL, and license key.

  • Space name: This is the name that will be displayed at the top of your login and dashboard.
  • Space URL: This is the URL you’ll use to access Backlog and is also used to create URLs for issue emails, etc.
  • License key: This is the license key displayed on the Enterprise Account page.

Entering administrator information

Assign a space owner who’ll manage your Backlog space. In addition to the privileges available to standard administrators, the space owner can:

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

Completing setup

Review and submit your space and license information.

Setup is now complete, and you’ll be automatically redirected to the Backlog login screen.

After initial setup

About the trademark

  • MySQL and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.
  • Docker is a trademark or a registered trademark of Docker, Inc. in the United States and/or other countries.
  • Amazon Web Services, AWS, and AWS CLI (Command Line Interface) are trademarks of Amazon.com, Inc. or its affiliates.
  • Linux® is the registered trademark of Linus Torvalds in the U.S. and other countries.
  • Red Hat Enterprise Linux is a trademark or a registered trademark of Red Hat Inc. in the United States and other countries.
  • Other company and product names in this document may be trademarks or registered trademarks of their respective owners.

Author: Backlog Support <support@backlog.com>