‍Are you looking for an efficient and user-friendly kanban board to streamline your project management? Look no further than Planka – a self-hosted Trello-like kanban board built with React and Redux. In this article, we will guide you through the process of installing Planka on AlmaLinux 9, enabling you to take advantage of its powerful features and enhance your project workflow.

Pre-requisites

Before we dive into the installation process, make sure you have the following pre-requisites in place:

• A system with AlmaLinux 9 installed and running.
• Root access to the system.
• Docker installed and running. If you haven’t installed Docker yet, you can refer to our guide on how to install Docker on AlmaLinux 9.
• Docker-Compose installed and running. If Docker-Compose is not set up on your system, you can follow our guide on installing Docker-Compose on AlmaLinux 9.

Once you have met these requirements, we can proceed with the installation and configuration of Planka.

Install Planka with Docker

To install Planka using Docker-Compose and Docker service, follow these steps:

1. Download the docker-compose configuration file by running the following command:

curl -L https://raw.githubusercontent.com/plankanban/planka/master/docker-compose.yml -o docker-compose.yml

2. Open the docker-compose.yml file and modify the following variables:

• BASE_URL: Change localhost to the actual IP address of your server.
• SECRET_KEY: Replace the default value with a random string or password for enhanced security.
• user-avatars: Set this to the path on your server where the user avatars will be stored.
• project-background-images: Specify the path on your server where the project background images will be stored.
• attachments: Set this to the path on your server where the attachments will be stored.
• db-data: Specify the path on your server where the database data will be stored.

Here is an example of the modified docker-compose.yml file:

version: '3'
services:
planka:
image: ghcr.io/plankanban/planka:latest
command: > 
bash -c "for i in `seq 1 30`; do ./start.sh && s=$$? && break || s=$$?; echo \"Tried $$i times. Waiting 5 seconds...\"; sleep 5; done; (exit $$s)"
restart: unless-stopped
volumes:
- user-avatars:/app/public/user-avatars
- project-background-images:/app/public/project-background-images
- attachments:/app/private/attachments
ports:
- 3000:1337
environment:
- BASE_URL=http://localhost:3000
- TRUST_PROXY=0
- DATABASE_URL=postgresql://postgres@postgres/planka
- SECRET_KEY=notsecretkey
depends_on:
- postgres
postgres:
image: postgres:14-alpine
restart: unless-stopped
volumes:
- db-data:/var/lib/postgresql/data
environment:
- POSTGRES_DB=planka
- POSTGRES_HOST_AUTH_METHOD=trust
volumes:
user-avatars:
project-background-images:
attachments:
db-data:

3. Start the Planka container using the following command:

docker-compose up -d

This command will initiate the installation process, which may take 5-10 minutes to complete. You can monitor the progress by checking the output of docker ps command:

[root@vps ~]# docker ps
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
e22e9f27a1e4 ghcr.io/plankanban/planka:latest "docker-entrypoint.s…" 19 minutes ago Up 19 minutes 0.0.0.0:3000->1337/tcp, :::3000->1337/tcp root-planka-17b15642535d3
7b15642535d3 postgres:14-alpine "docker-entrypoint.s…" 19 minutes ago Up 19 minutes 5432/tcp root-postgres-1

Accessing Planka

Once the installation is complete, you can access Planka by opening the IP address or domain name in your browser. Replace server.ip.address with the actual IP or domain configured on your server. The URL should look like this:

http://server.ip.address:3000/login

Upon accessing the Planka login page, use the following credentials to log in:

• Username: demo@demo.demo
• Password: demo

After logging in, you can customize various settings, such as changing the username, password, and email ID, by navigating to the Settings menu.

Congratulations! You have successfully installed Planka with Docker on AlmaLinux 9. Now you can enjoy the benefits of this powerful kanban board and optimize your project management workflow.

Additional Information

At Shape.host, we offer reliable and scalable Cloud VPS services to empower businesses with efficient hosting solutions. Our team of experts is dedicated to providing top-notch customer support, ensuring a hassle-free experience for our clients. Whether you’re a small startup or a large enterprise, Shape.host has the tools and expertise to meet your hosting needs. Visit our website to learn more about our services and get started with Shape.host today.

Remember, Planka is a versatile tool that can be customized to suit your specific project management requirements. Explore its features, experiment with different configurations, and unleash its full potential to boost your team’s productivity.

Christian Wells