How to install Planka on Docker using Portainer

Introduction

This tutorial will guide you through the process of installing Planka on Docker using Portainer. Planka is an open-source kanban board application similar to Trello, built with React and Redux. By following these steps, you'll be able to self-host Planka efficiently.

Step 1: Set Up Docker and Portainer

Before installing Planka, ensure that you have Docker and Portainer installed.

• If you haven't installed Docker yet, refer to the official tutorial here.
• For installing Portainer, follow the tutorial here.

Practical Tips

• Make sure your Docker installation is up to date to avoid compatibility issues.
• Check that your system meets the requirements for running Docker.

Step 2: Access Portainer

Once Docker and Portainer are installed, access the Portainer web interface.

• Open a web browser and navigate to http://localhost:9000 (or the appropriate IP address if accessing remotely).
• Log in with your Portainer credentials.

Step 3: Create a New Stack for Planka

In Portainer, you'll create a new stack to deploy Planka.

• Go to the "Stacks" section in the Portainer dashboard.
• Click on "Add stack."
• Name your stack (e.g., "Planka").

Step 3.1: Define the Stack Configuration

You will need to add a configuration for Planka in the stack. Use the following template:

version: '3'

services:
  planka:
    image: meltyshev/planka
    restart: unless-stopped
    ports:
      - "3000:3000"
    environment:
      - MONGO_URL=mongodb://mongo:27017/planka
      - MONGO_INITDB_ROOT_USERNAME=root
      - MONGO_INITDB_ROOT_PASSWORD=example
    depends_on:
      - mongo

  mongo:
    image: mongo
    restart: unless-stopped
    environment:
      - MONGO_INITDB_ROOT_USERNAME=root
      - MONGO_INITDB_ROOT_PASSWORD=example
    volumes:
      - mongo_data:/data/db

volumes:
  mongo_data:

Practical Tips

• Modify the environment variables as needed, especially the MongoDB username and password for security.
• Ensure that the ports do not conflict with other services on your system.

Step 4: Deploy the Stack

After defining your stack configuration, deploy it.

• Click on "Deploy the stack" at the bottom of the page.
• Wait for Portainer to pull the necessary images and start the containers.

Common Pitfalls

• Check for any error messages during deployment. If an error occurs, verify your configuration for typos or missing parameters.

Step 5: Access Planka

Once the stack is deployed successfully, you can access Planka.

• Open a browser and go to http://localhost:3000.
• Follow the on-screen instructions to set up your Planka instance.

Conclusion

You have successfully installed Planka on Docker using Portainer. You can now enjoy a self-hosted kanban board for your projects. For further customization, explore the Planka documentation available on their website or GitHub. Happy organizing!