Added Planka v2 to BigBearUniversal Apps

Big Bear Universal Apps Big Bear Universal Apps - Releases
1

I’m excited to announce that Planka v2 has been added to BigBearUniversal Apps!

What is Planka v2?

Planka v2 is the latest major release of the free, open source, real-time kanban board for workgroups, built with React and Redux. Version 2.0.1 brings a modernized architecture with a unified data directory, enhanced security features including SSRF protection, and a suite of new collaboration tools.

This PR adds Planka v2 as a separate, standalone app alongside the existing Planka v1 (now marked as legacy), allowing both versions to run simultaneously on different ports.

What’s New in Planka v2?

  • Enhanced Security: SSRF protection via configurable OUTGOING_BLOCKED_HOSTS
  • Unified Data Directory: All data consolidated under /app/data for simpler backups and migrations
  • User Mentions: Tag teammates directly in cards and comments
  • Task Linking: Link related cards across boards
  • Webhooks UI: Manage webhooks from within the interface
  • SMTP Configuration UI: Configure email notifications from the UI
  • OIDC Authentication: OpenID Connect single sign-on support
  • Configurable Upload Limits: MAX_UPLOAD_FILE_SIZE and STORAGE_LIMIT controls
  • Port Separation: Runs on port 3001 (host) to avoid conflicts with v1’s port 3000

App Stores

Planka v2 is available on the following app stores:

Pull Request

The pull request for this addition can be found here: feat-add-planka-v2-and-legacy by dragonfire1119 · Pull Request #1284 · bigbeartechworld/big-bear-universal-apps · GitHub

Configuration

Default Settings

  • Port: 3001 (maps to container port 1337)
  • Image: ghcr.io/plankanban/planka:2.0.1
  • Architectures: amd64, arm64
  • Data Storage: /app/data (unified data directory)

Default Credentials

Email: [email protected]

Password: demo

Please change the default credentials after your first login.

Required Environment Variables

  • BASE_URL: The base URL where Planka will be accessed (e.g., http://[YOUR_LAN_IP]:3001)
  • DATABASE_URL: PostgreSQL connection URL
  • SECRET_KEY: Secret key for session encryption — change this in production!
  • DEFAULT_ADMIN_EMAIL: Admin email for initial setup
  • DEFAULT_ADMIN_PASSWORD: Admin password for initial setup
  • DEFAULT_ADMIN_NAME: Admin display name
  • DEFAULT_ADMIN_USERNAME: Admin username

Optional Environment Variables

  • TRUST_PROXY: Set to true if running behind a reverse proxy
  • TOKEN_EXPIRES_IN: Token expiration in days (default: 365)
  • DEFAULT_LANGUAGE: Default UI language (default: en-US)
  • MAX_UPLOAD_FILE_SIZE: Max file upload size in bytes (default: 100MB)
  • STORAGE_LIMIT: Total storage limit in bytes (0 = unlimited)
  • ACTIVE_USERS_LIMIT: Max active users (0 = unlimited)
  • OUTGOING_BLOCKED_HOSTS: Comma-separated hosts to block for SSRF protection
  • OIDC_ISSUER / OIDC_CLIENT_ID / OIDC_CLIENT_SECRET: OpenID Connect configuration

Important Notes for v1 Users

:warning: Migration is ONE-WAY with NO ROLLBACK capability.

  • Do NOT uninstall your existing Planka v1 app — deploy this as a NEW app alongside it
  • You must be on Planka v1 >= 1.26.2 before migrating
  • Subdomain hosting is required for the migration
  • Follow the official migration guide: Docker | PLANKA Docs

For new deployments, simply install Planka v2 directly — no migration needed.

Resources

Support

Need help or have questions? Visit our community forum: https://community.bigbeartechworld.com/

Support BigBearTechWorld: https://ko-fi.com/bigbeartechworld