OpenProject is a web-based project management system for location-independent team collaboration. With features such as Project planning and scheduling, Product roadmap and release planning, Team Collaboration, Kanban, Agile & Scrum, Time Tracking, amongst others, it is one of the most popular project management systems

In this guide, we will explain how to install OpenProject on an Ubuntu 16.04 and an Ubuntu 18.04 server.

Deploying your cloud server
If you have not already registered with Cloudwafer, you should begin by getting signed up. Take a moment to create an account after which you can easily deploy your own cloud servers.

Once you have signed up, log into your Cloudwafer Client Area and deploy your Cloudwafer cloud server.

Step 1: Import the packager.io repository signing key
Import the PGP key used to sign the OpenProject packages using the command below:

wget -qO- https://dl.packager.io/srv/opf/openproject-ce/key | sudo apt-key add -

Step 2: Install apt-transport-https if it not installed
The OpenProject repository requires apt to have https support. If this is not done yet, issue the command below to install. If you are not sure if it is installed, you can also issue the command to check.

sudo apt-get install apt-transport-https

Ubuntu 16.04 Ubuntu 16.04 Ubuntu 18.04 Ubuntu 18.04

Step 3: Ensure that the universe package source is added
To avoid issues trying to install the dialog package which is required for our installation on Ubuntu 18.04, issue the command below to add the universe package

sudo add-apt-repository universe

Step 4: Add the OpenProject package source
For Ubuntu 16.04, issue the command below:

sudo wget -O /etc/apt/sources.list.d/openproject-ce.list \
  https://dl.packager.io/srv/opf/openproject-ce/stable/8/installer/ubuntu/16.04.repo

For Ubuntu 18.04, issue the command below:

sudo wget -O /etc/apt/sources.list.d/openproject-ce.list \
  https://dl.packager.io/srv/opf/openproject-ce/stable/8/installer/ubuntu/18.04.repo

Step 5: Update the Apt Package List
Update your index files to match the current contents of the repositories using the apt-get command below. apt will check the new package source and install the package and all required dependencies.

sudo apt-get update

Ubuntu 16.04 Cloudwafer Ubuntu 16.04

Ubuntu 18.04 Cloudwafer Ubuntu 18.04

Step 6: Install the OpenProject Community Edition package
Lastly, issue the command below to install the community edition package of OpenProject. Press y when prompted to continue.

sudo apt-get install openproject

Ubuntu 16.04 Cloudwafer Ubuntu 16.04 Ubuntu 18.04 Cloudwafer Ubuntu 18.04

Step 7: Openproject Post-Install Configuration
After successfully installing OpenProject, there are other packages that need to be installed and configured. The database will be configured using MySQL, web-server using Apache, adding a domain name, adding support for Git and SVN, configure email notification, and enable Memcached for the application cache. To begin, issue the openproject command below.

sudo openproject configure

Next, you would receive the wizard for openproject database configuration as shown below.

  • PostgreSQL Server installation:

  • Web Server - Apache Installation:

  • Domain Configuration:

  • Server Path Prefix:

  • SSL:

  • SVN Install:

  • GIT Install:

  • SMTP:

  • Memcached Server:

Lastly, Open your web browser and type on the address bar your openproject URL, and you'll be greeted by the default page. To log in to the admin dashboard - use 'admin' as a user and password.