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:
- 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
- Open the
docker-compose.yml
file and modify the following variables:
BASE_URL
: Changelocalhost
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:
- 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.