In this article, we will guide you through the process of installing Planka with Docker on Rocky Linux 8. Planka is a self-hosted kanban board built with React and Redux, offering a Trello-like experience. By installing Planka, you can streamline your project management and enhance collaboration within your team. With Docker, the installation process becomes straightforward and efficient. So, let’s dive in and get started!
Pre-requisites
Before we begin, let’s ensure that we have all the necessary pre-requisites in place.
System Requirements
To install Planka with Docker on Rocky Linux 8, you will need:
- A system with Rocky Linux 8 installed and running
- Root access to the system
Installing Docker
To install Docker on Rocky Linux 8, follow these steps:
- Open a terminal on your Rocky Linux 8 system.
- Execute the following command to install Docker:
sudo dnf install docker
- Start the Docker service:
sudo systemctl start docker
- Enable Docker to start on boot:
sudo systemctl enable docker
Installing Docker-Compose
To install Docker-Compose on Rocky Linux 8, follow these steps:
- Open a terminal on your Rocky Linux 8 system.
- Execute the following command to download the Docker-Compose binary:
sudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
- Provide executable permissions to the binary:
sudo chmod +x /usr/local/bin/docker-compose
- Verify the installation by running the following command:
docker-compose --version
Installing Planka with Docker
Now that we have fulfilled the pre-requisites, let’s proceed with the installation of Planka using Docker.
Downloading the Docker-Compose Configuration
To download the Docker-Compose configuration for Planka, execute the following command:
sudo curl -L https://raw.githubusercontent.com/plankanban/planka/master/docker-compose.yml -o docker-compose.yml
Configuring the Docker-Compose file
After downloading the Docker-Compose file, we need to make some necessary configurations before starting the Planka container. Open the docker-compose.yml
file in a text editor and update the following variables:
BASE_URL
: Changelocalhost
to the actual IP address of your server.SECRET_KEY
: Set a random string/password for enhanced security.user-avatars
: Set the path within your server where the user avatars will be stored.project-background-images
: Set the path within your server where the project background images will be stored.attachments
: Set the path within your server where the attachments will be stored.db-data
: Set the path within your server where the database data will be stored.
For example:
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:
Starting the Planka Container
To start the Planka container, run the following command:
docker-compose up -d
The installation process will begin, and it may take a few minutes to complete. You can monitor the progress by checking the output of the following command:
docker ps
Once the Planka container is running, you will see the container ID and other details in the output.
Accessing Planka
To access Planka, open a web browser and enter the IP address or domain name of your server, followed by port 3000. For example, http://server.ip.address:3000/login
.
Replace server.ip.address
with the actual IP or domain configured on your server.
Upon accessing Planka, you will be redirected to the Appwrite login page. The default login credentials are as follows:
- Username: demo@demo.demo
- Password: demo
After logging in, you can customize various settings, including changing the username, password, and email ID. Simply navigate to the Settings menu and modify the desired information.
Conclusion
Congratulations! You have successfully installed Planka with Docker on Rocky Linux 8. By implementing this self-hosted kanban board, you can enhance your project management capabilities and improve collaboration within your team. Planka’s intuitive interface and powerful features make it an ideal choice for organizing tasks and tracking progress. Enjoy the benefits of efficient project management with Planka!
For reliable and scalable Linux SSD VPS hosting, consider Shape.host. Our Shape.host services provide exceptional performance and security for your applications. Experience the difference with Shape.host today!