How to deploy the on-site version of Orangescrum

If you want to host a project management tool in your data center, look no further than Orangescrum.

An agile software developer updates the Kanban board.
Image: Berk/Adobe Stock

Hosting a project management solution in either your company’s data center or a third-party cloud host is a great way to protect highly sensitive project information. Not only is all your data never seen by a third party, but you also have full control over how the platform is accessed.

SEE: Employment set: Project manager (TechRepublic Premium)

If that sounds like something that would benefit your business, you’re in luck, because several project management tools can be installed locally. One such tool is Orangescrum, which includes all the basic tools you need to manage your projects.

In this tutorial, I will show you how to easily deploy Orangescrum using Docker. It’s quite easy to get started, so you only need a few minutes for on-site deployment.

Jump to:

What you need to deploy Orangescrum as a Docker container

The only thing you need for this deployment is a server with an operating system that supports Docker. I will demonstrate how to deploy Orangescrum on Ubuntu Server 20.04; if you follow me and use the same, you also need a user with sudo rights. That’s it. Let’s get to the deployment.

SEE: How to install and deploy a Docker Swarm cluster (TechRepublic Premium)

How to install Docker

If you don’t already have Docker installed, here are the steps you need to follow:

1. Add the official Docker GPG key with the command:

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg

2. Next, add the Docker repository:

echo "deb [arch=amd64 signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

3. Install a few quick dependencies with the command:

sudo apt-get install apt-transport-https ca-certificates curl gnupg lsb-release -y

4. Install the latest version of Docker CE with the following commands:

sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io -y

5. Make sure your user is still a member of the Docker group with the command:

sudo usermod -aG docker $USER

6. Log off and on again for the changes to take effect.

How to deploy Orangescrum with Docker

The first thing we need to do is deploy the orangescrum-db with the command:

docker run -d -p 3306:3306 --name=osdb orangescrum/orangescrum-db

Next, we deploy the Orangescrum server, and connect it to the database app with the command:

docker run -d -p 8000:80 --name=osapp --link=osdb orangescrum/orangescrum-app

If you want, you can change the external port from 8000 to another port. I used 8000 because both 80 and 8080 were already in use.

Give the containers a few minutes to spin up. You can check the status of the containers with this command:

docker ps -a

Once both containers are up and running, open a browser and point to it http://SERVER:8000, where SERVER is the IP address or domain of the host server. You should see the Orangescrum SMTP configuration window (Figure A).

Figure A

Configure your SMTP server for Orangescrum.
Configure your SMTP server for Orangescrum.

Fill in the required information and click Finish. You can use Google’s SMTP server here if you want; just make sure you create an app password for your Gmail account.

You will then be asked to create a new user. Once you’ve done that, you’ll find yourself in the main Orangescrum window (Figure B), where you can create your first project.

Figure B

Orangescrum has been deployed.
Orangescrum has been deployed.

Uses Orangescrum for project management

Orangescrum is one of the easiest internal project management tools available to install. If you’re looking to manage small to medium-sized projects in-house, this may well be one of the fastest routes to success. Try this distribution and see if it doesn’t suit your needs.

Read next: The 10 Best Project Management Software and Tools (TechRepublic)

Leave a Reply

Your email address will not be published. Required fields are marked *