SSD Nodes Learn Hosting plans →

Docker Compose மூலம் Planka-வை VPS-ல் நிறுவுவது எப்படி?

Docker Compose, Postgres மற்றும் Traefik பயன்படுத்தி Planka-வை நிறுவும் முறை. BASE_URL அமைப்பில் ஏற்படும் பிழைகளைத் தவிர்த்து, உங்கள் Kanban board-ஐ வெற்றிகரமாக இயக்குவது எப்படி?

Planka-வை self-hosting செய்வதன் மூலம் நீங்கள் பெறுபவை

Planka-வை நீங்களே host செய்வதன் மூலம், Trello-வில் ஏற்கனவே பழக்கப்பட்ட card, list மற்றும் label மாதிரியிலான Kanban board உங்கள் கட்டுப்பாட்டில் உள்ள VPS-ல் கிடைக்கும். இதில் பயனர் எண்ணிக்கைக்கு வரம்போ அல்லது தனிநபர் கட்டணமோ கிடையாது, ஏனெனில் server-க்கான செலவு மட்டுமே உங்களுக்கு ஏற்படும். இந்த வழிகாட்டி, Traefik-க்கு பின்னால் Docker Compose மூலம் இதை நிறுவுகிறது; தரவுகளுக்கு Postgres-ஐயும், பயனர்கள் பதிவேற்றும் கோப்புகளுக்கு named volume-ஐயும் பயன்படுத்துகிறது.

Planka 2, அந்தத் திட்டத்தின் சொந்த Fair Use License-ன் கீழ் வெளியிடப்படுகிறது. இது open source என்பதற்குப் பதிலாக source-available என்று அந்தத் திட்டத்தால் விவரிக்கப்படுகிறது. உங்கள் நிறுவனத்தின் உள்நாட்டுத் திட்டங்களுக்கு இதை இயக்குவது அனுமதிக்கப்படுகிறது. மூன்றாம் தரப்பினருக்கு வணிக ரீதியான hosted சேவையாக இதை வழங்குவதற்கு Pro அல்லது Enterprise உரிமம் தேவை.

Trello-வின் இலவசத் திட்டத்திலிருந்து வெளியேறும் இரண்டு முதல் ஐந்து பேர் கொண்ட குழுவினரை நான் இலக்காகக் கொண்டுள்ளேன். எந்த board-ஐப் பயன்படுத்துவது என்று நீங்கள் இன்னும் முடிவு செய்யவில்லை என்றால், முதலில் self-hosted Trello மாற்றுகளின் ஒப்பீட்டை வாசிக்கவும். இந்த வழிகாட்டி, நீங்கள் ஏற்கனவே முடிவெடுத்துவிட்டதாகக் கருதி, நிறுவுதலை (deploy) மட்டுமே விளக்குகிறது.

உங்களுக்கு Docker Engine மற்றும் Compose plugin இயங்கும் ஒரு VPS-ம், அதைச் சுட்டிக்காட்டும் ஒரு DNS A record-ம் தேவை. மேலும், அந்த server-ல் ஏற்கனவே TLS (transport layer security) termination செய்யும் Traefik instance இருக்க வேண்டும். Traefik இன்னும் நிறுவப்படவில்லை என்றால், முதலில் பல Compose apps-க்கு முன்னால் ஒரு Traefik reverse proxy-ஐ அமைக்கவும், கீழே உள்ள கோப்பு உங்களுக்குப் புரியவில்லை என்றால் Docker Compose-ன் அடிப்படை அம்சங்களை வாசிக்கவும்.

Planka-விற்கு எவ்வளவு VPS தேவை?

இந்தத் திட்டத்தின் தொழில்நுட்ப FAQ, சிறிய குழுக்களுக்குக் குறைந்தபட்சம் 2 GB RAM மற்றும் 10 GB சேமிப்புத் திறன் தேவை என்று பரிந்துரைக்கிறது. எனவே, இந்த எண்களை ஒரு அளவீடாகக் கருதாமல், தொடக்கப் புள்ளியாகக் கருதுங்கள்.

உண்மையில் இயங்குவது சிறியது: API மற்றும் கட்டமைக்கப்பட்ட frontend-ஐ வழங்கும் ஒரு Node.js process, மற்றும் தரவுகளைச் சேமிக்கும் ஒரு Postgres server. இது ஒரு மேற்பார்வை process மற்றும் ஒவ்வொரு திறந்த இணைப்புக்கும் ஒரு backend process-ஐ இயக்குகிறது. Planka container-க்குள் ஒரு சிறிய proxy process-ம் அதன் வெளிச்செல்லும் கோரிக்கைகளை வடிகட்ட இயங்குகிறது. 2 GB திட்டம், சிறிய குழுக்களுக்கான திட்டத்தின் RAM பரிந்துரைக்கு இணங்குகிறது. ஒரு board என்பது ஒரு இலகுவான அண்டை மென்பொருள்; எனவே, அதே VPS-ல் உங்கள் குழுவின் ஆவணங்களையும் வைத்திருக்கத் திட்டமிட்டால், அந்த application-க்கு முதலில் அளவு நிர்ணயம் செய்யுங்கள்: Notion போன்ற workspace-ஆக AFFiNE-ஐ இயக்குதல் என்பதற்கு Planka எதையும் கோருவதற்கு முன்பே சில GB தேவைப்படும்.

நினைவகத்திற்கு அளவு நிர்ணயம் செய்வதற்கு முன்பே வட்டை (disk) அளவு நிர்ணயம் செய்யுங்கள், ஏனெனில் இணைப்புகள் (attachments) தான் வளரக்கூடிய பகுதி. இந்த பத்தியை நம்புவதற்குப் பதிலாக உங்கள் சொந்த instance-ஐ அளவிடுங்கள்:

docker stats --no-stream
docker system df -v

முதல் கட்டளை ஒவ்வொரு container-ன் நேரடி நினைவகம் மற்றும் CPU பயன்பாட்டைக் காட்டுகிறது. இரண்டாவது கட்டளை ஒவ்வொரு volume-ம் எவ்வளவு இடத்தை எடுத்துக்கொள்கிறது என்பதைக் காட்டுகிறது. நிறுவிய நாளில் எடுக்காமல், ஒரு சாதாரண வேலை வாரத்திற்குப் பிறகு இரண்டு அளவீடுகளையும் எடுங்கள், ஏனெனில் செயலற்ற நிலையில் இருக்கும் ஒரு board உங்கள் குழுவைப் பற்றி எதையும் சொல்லாது.

Compose கோப்பை எழுதுதல்

கோப்பகத்தை உருவாக்கி, அதன் உரிமையைப் பெற்றுக்கொள்ளுங்கள். இதன் மூலம் நீங்கள் sudo மூலம் இந்த கோப்புகளைத் திருத்த வேண்டிய அவசியம் இருக்காது.

sudo mkdir -p /opt/planka
sudo chown "$USER":"$USER" /opt/planka
cd /opt/planka

ரகசியங்களை (secrets) Compose கோப்பிற்கு அருகிலேயே ஒரு .env கோப்பில் உருவாக்குங்கள். Compose அந்த கோப்பைத் தானாகவே வாசித்து, மதிப்புகளைப் பிரதியிடும்.

umask 077
{
  printf 'SECRET_KEY=%s\n' "$(openssl rand -hex 64)"
  printf 'POSTGRES_PASSWORD=%s\n' "$(openssl rand -hex 24)"
  printf 'ADMIN_PASSWORD=%s\n' "$(openssl rand -hex 12)"
} > .env
chmod 600 .env

openssl rand -hex என்பது திட்டமிட்டே பயன்படுத்தப்படுகிறது. ஒரு hex string-ல் எண்களும் a முதல் f வரையிலான எழுத்துக்களும் மட்டுமே இருக்கும் என்பதால், அது தான் ஒட்டப்படும் DATABASE_URL connection string-ஐப் பாதிக்காது. சாதாரண Base64-ல் slash, plus sign மற்றும் padding equals sign இருக்கலாம், ஆனால் at sign இருக்காது; connection URL-ல் சிறப்பு அர்த்தம் கொண்ட எழுத்துக்களுக்கு percent-encoding தேவை. இது குறித்த விரிவான விளக்கம் Compose கோப்பிற்கு வெளியே ரகசியங்களை வைத்திருத்தல் பகுதியில் உள்ளது.

இப்போது docker-compose.yml. kanban.example.com என்பதற்குப் பதிலாக, அது தோன்றும் இரண்டு இடங்களிலும் உங்கள் சொந்த hostname-ஐக் குறிப்பிடவும்.

services:
  planka:
    image: ghcr.io/plankanban/planka:2.2.1
    restart: unless-stopped
    volumes:
      - planka-data:/app/data
    environment:
      - BASE_URL=https://kanban.example.com
      - DATABASE_URL=postgresql://planka:${POSTGRES_PASSWORD}@postgres/planka
      - SECRET_KEY=${SECRET_KEY}
      - TRUST_PROXY=true
      - DEFAULT_ADMIN_EMAIL=you@example.com
      - DEFAULT_ADMIN_PASSWORD=${ADMIN_PASSWORD}
      - DEFAULT_ADMIN_NAME=Your Name
      - DEFAULT_ADMIN_USERNAME=admin
    networks:
      - proxy
      - internal
    labels:
      - "traefik.enable=true"
      - "traefik.docker.network=proxy"
      - "traefik.http.routers.planka.rule=Host(`kanban.example.com`)"
      - "traefik.http.routers.planka.entrypoints=websecure"
      - "traefik.http.routers.planka.tls.certresolver=default"
      - "traefik.http.services.planka.loadbalancer.server.port=1337"
    depends_on:
      postgres:
        condition: service_healthy

  postgres:
    image: postgres:16-alpine
    restart: unless-stopped
    volumes:
      - db-data:/var/lib/postgresql/data
    environment:
      - POSTGRES_DB=planka
      - POSTGRES_USER=planka
      - POSTGRES_PASSWORD=${POSTGRES_PASSWORD}
    networks:
      - internal
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U planka -d planka"]
      interval: 10s
      timeout: 5s
      retries: 5

volumes:
  planka-data:
  db-data:

networks:
  proxy:
    external: true
  internal:

அந்தக் கோப்பில் எடுக்கப்பட்ட நான்கு முடிவுகள் விளக்கத்திற்குரியவை, ஏனெனில் அவற்றை மாற்றிய பிறகுதான் பயனர்கள் சிக்கல்களைச் சந்திக்கின்றனர்.

  • Planka service-ல் ports: தொகுதி இல்லை. Traefik ஆனது proxy network வழியாக container-ஐ அடைகிறது, எனவே port 1337 host-ல் ஒருபோதும் வெளியிடப்படாது (publish). அதை வெளியிடுவது, உங்கள் proxy மற்றும் certificate-ஐத் தவிர்த்துவிட்டு எவரும் உள்ளே நுழைய வழிவகுக்கும்.
  • loadbalancer.server.port=1337 என்பது container-க்குள் இருக்கும் port-ஐக் குறிக்கிறது. Planka 1337-ல் இயங்குகிறது, ஆனால் upstream உதாரணம் 3000-ல் மட்டுமே அதை அடைகிறது, ஏனெனில் அது port-ஐ host-க்கு map செய்கிறது. இங்கே host mapping இல்லாததால், container port-ஐ Traefik-க்குத் தெரிவிக்க வேண்டும்.
  • condition: service_healthy என்பது Postgres healthcheck-உடன் இணைகிறது. இது இல்லையென்றால், database இணைப்புகளை ஏற்கும் முன்பே Planka தொடங்க முயற்சிக்கும், முதல் query-ல் தோல்வியடைந்து வெளியேறும்; இது crash loop போலத் தோன்றும். இதன் செயல்பாடுகள் Compose healthchecks மற்றும் startup ordering பகுதியில் உள்ளன.
  • database service-க்கு postgres என்று பெயரிட்டது வேண்டுமென்றே செய்யப்பட்டது. Planka 2 தனது வெளிச்செல்லும் கோரிக்கைகளை (outgoing requests) ஒரு internal filter வழியாக அனுப்புகிறது, அதன் default block list localhost,postgres ஆகும். service-ன் பெயரை மாற்றினால், உங்கள் database அந்தப் பட்டியலிலிருந்து நீக்கப்பட்டுவிடும்.

எதையும் தொடங்கும் முன், Compose உங்கள் ரகசியங்களைப் பார்க்க முடிகிறதா என்று சரிபார்க்கவும்:

docker compose config | grep -E 'image:|BASE_URL|POSTGRES_USER'

இது .env மதிப்புகள் ஏற்கனவே பிரதியிடப்பட்ட கோப்பை அச்சிடும். மதிப்பு காலியாக இருந்தால், Compose .env கோப்பை வாசிக்கவில்லை என்று அர்த்தம்; பெரும்பாலும் நீங்கள் வேறு கோப்பகத்திலிருந்து கட்டளையை இயக்குவதால் இது நிகழ்கிறது.

நிர்வாக bootstrap மாறிகள் உண்மையில் என்ன செய்கின்றன

Planka 1.13 பதிப்பிலிருந்து உங்களுக்காக நிர்வாகி யாரும் உருவாக்கப்படுவதில்லை, எனவே புதிய database-ல் உள்நுழைய யாருக்கும் அனுமதி இருக்காது. DEFAULT_ADMIN_* குழு அதைச் சரிசெய்வதற்கான இரண்டு வழிகளில் ஒன்றாகும்.

தொடக்கத்தின்போது, DEFAULT_ADMIN_EMAIL-க்கு இணையான பயனரை Planka தேடுகிறது. யாரும் இல்லையென்றால், அதனுடன் அமைக்கப்பட்டுள்ள கடவுச்சொல், காட்சிப் பெயர் மற்றும் பயனர் பெயரைப் பயன்படுத்தி ஒருவரை உருவாக்குகிறது. அடுத்தடுத்த தொடக்கங்களின்போது, இந்த மாறிகளிலிருந்து பொருந்தக்கூடிய கணக்கின் விவரங்களை அது புதுப்பிக்கும்; இதில் DEFAULT_ADMIN_PASSWORD அமைக்கப்பட்டிருக்கும்போது அதன் கடவுச்சொல்லை மீண்டும் அமைப்பதும் அடங்கும்.

DEFAULT_ADMIN_EMAIL மற்றொன்றையும் செய்கிறது, இது பயனர்களைச் சிக்கலில் தள்ளும். இந்த மாறி அமைக்கப்பட்டிருக்கும் வரை, அது குறிப்பிடும் கணக்கின் பெயர், பங்கு அல்லது மின்னஞ்சல் முகவரியை interface மூலம் மாற்றவோ அல்லது நீக்கவோ முடியாது. இது ஒரு பாதுகாப்பு பூட்டு (lock-out guard), இதனால்தான் அந்த கணக்கின் பெயரை மாற்றவோ அல்லது அதன் மின்னஞ்சல் முகவரியை UI-ல் மாற்றவோ முடியாது. மாறியை நீக்கிவிட்டு restart செய்யுங்கள், அப்போது அந்தக் கணக்கு மற்றவர்களைப் போலவே நீங்கள் திருத்தக்கூடிய சாதாரண நிர்வாகியாக மாறும்.

கடவுச்சொல் வரியைக் கையாளும்போது கவனமாக இருக்க வேண்டும். environment:-க்குக் கீழே உள்ள எதையும் container-ல் docker inspect-ஐ இயக்கக்கூடிய எவரும் படிக்க முடியும், எனவே DEFAULT_ADMIN_PASSWORD நிரந்தரமாக அங்கு இருக்கக்கூடாது. உள்நுழைந்து, அந்த வரியை நீக்கிவிட்டு, மீண்டும் docker compose up -d-ஐ இயக்கவும், பின்னர் interface-ல் உங்கள் கடவுச்சொல்லை மாற்றவும்.

சுத்தமான வழி, மாறிகளைத் தவிர்ப்பதாகும். முழு DEFAULT_ADMIN_* குழுவையும் comment out செய்துவிட்டு, பின்னர் கணக்கை ஊடாடும் முறையில் (interactively) உருவாக்குங்கள்:

docker compose run --rm planka npm run db:create-admin-user

இது மின்னஞ்சல், கடவுச்சொல், காட்சிப் பெயர் மற்றும் விருப்பத்தேர்வான பயனர் பெயரைத் கேட்கும், மேலும் பயனரை நேரடியாக database-ல் எழுதும். கடவுச்சொல் ஒருபோதும் Compose கோப்பையோ அல்லது container-ன் கட்டமைக்கப்பட்ட சூழலையோ தொடாது. VPS-க்கு ஒன்றுக்கும் மேற்பட்ட நபர்களுக்கு shell அணுகல் இருந்தால் இந்த வழியைப் பயன்படுத்துங்கள். depends_on காரணமாக இந்த கட்டளை முதலில் Postgres-ஐத் தொடங்கும், எனவே இது இதுவரை இயங்காத stack-லும் வேலை செய்யும்.

எந்த வழியைப் பின்பற்றினாலும் Planka கடவுச்சொற்களை நீங்களே கையாள வேண்டியிருக்கும். 2.1.1 பதிப்பு வரை, Community edition ஆனது உங்கள் சொந்த single sign-on server-ஆக இயங்கும் Authentik போன்ற OIDC வழங்குநரிடம் உள்நுழைவுகளை ஒப்படைக்க முடிந்தது. ஆனால், ஆகஸ்ட் 2026-ல் வெளியிடப்பட்ட 2.2.0 பதிப்பு, OIDC மற்றும் SSO-வை PLANKA Pro-விற்கு மாற்றியது. அதே வெளியீட்டில் Community edition-க்குக் கிடைத்தது உள்ளூர் கணக்குகளுக்கான இரு காரணி அங்கீகாரம் (TOTP) ஆகும், எனவே நிர்வாகி கணக்கிற்காவது அதைச் செயல்படுத்தவும்.

BASE_URL, hostname-உடன் பொருந்தாதபோது ஏன் login-ஐப் பாதிக்கிறது

BASE_URL என்பது பயனர்கள் browser-ல் தட்டச்சு செய்யும் சரியான முகவரி ஆகும்; இதில் scheme இருக்க வேண்டும், இறுதியில் slash இருக்கக்கூடாது. இந்த stack-க்கு அது https://kanban.example.com ஆகும். Planka அந்த மதிப்பைக் கொண்டே தனது சொந்த இணைப்புகளையும், அனுமதிக்கப்பட்ட WebSocket origins பட்டியலையும் உருவாக்குகிறது. எனவே, தவறான BASE_URL இருந்தால், அது தெளிவான பிழைச் செய்தியைக் காட்டாது. மாறாக, பக்கம் லோட் ஆகும், ஆனால் லோடிங் முடிவடையாமல் அப்படியே நிற்கும்.

பொதுவான தவறு இதுதான்: நீங்கள் upstream example-ஐ நகலெடுத்து, BASE_URL=http://localhost:3000-ஐ அப்படியே விட்டுவிட்டு, உங்கள் உண்மையான domain-ல் HTTPS மூலம் தளத்தை அணுகுவீர்கள். Login form சமர்ப்பிக்கப்பட்டு, உங்கள் விவரங்கள் ஏற்றுக்கொள்ளப்படும். ஆனால், board திரையில் தோன்றாது. Browser developer console-ஐத் திறந்து பார்த்தால், /socket.io/-க்கான கோரிக்கைகள் தோல்வியடைவதைக் காணலாம். ஏனெனில், socket browser பக்கத்தின் origin-உடன் இணைகிறது, ஆனால் server-ன் origin restriction, BASE_URL-லிருந்து பெறப்பட்ட origin-ஐ மட்டுமே அனுமதிக்கிறது.

TRUST_PROXY=true என்பது இதே சிக்கலின் மற்றொரு பாதி ஆகும். Planka, Traefik-க்கு பின்னால் இயங்குவதால், ஒவ்வொரு கோரிக்கையும் Docker network-க்குள் proxy-ன் முகவரியிலிருந்து plain HTTP வழியாகவே அதை வந்தடையும். TRUST_PROXY இல்லையென்றால், Traefik அமைக்கும் X-Forwarded-Proto மற்றும் X-Forwarded-For headers-ஐ app புறக்கணித்துவிடும். இதனால், இணைப்பு பாதுகாப்பற்றது என்று அது கருதி, அனைத்து client-களையும் ஒரே IP முகவரியாகக் கையாளும். இதை அமைப்பதன் மூலம், app அந்த headers-ஐப் படித்து, scheme குறித்து browser-உடன் ஒத்துப்போகும்.

Traefik எந்த கூடுதல் அமைப்பும் இன்றி WebSockets-ஐ proxy செய்கிறது, இதனால்தான் இதற்கு முன்னுரிமை அளிக்கப்படுகிறது. Nginx-ல், proxy-ஆனது upgrade headers-ஐ, அதாவது proxy_set_header Upgrade $http_upgrade மற்றும் proxy_set_header Connection "upgrade"-ஐ forward செய்ய வேண்டும்; இல்லையெனில், வேறு காரணத்தால் அதே spinner சிக்கல் ஏற்படும். இவற்றை பொதுவான location / block-ல் வைக்கலாம்; /socket.io-க்காகத் தனி block-ம் வேலை செய்யும், ஆனால் அது கட்டாயமல்ல.

Board-ஐப் பிற்காலத்தில் புதிய hostname-க்கு மாற்றும்போது, இரண்டு விஷயங்களைச் சேர்த்து மாற்ற வேண்டும்: BASE_URL மதிப்பு மற்றும் Traefik Host() விதி. ஒன்றை மாற்றிவிட்டு மற்றொன்றை மறந்துவிட்டால், மீண்டும் spinner சிக்கலே ஏற்படும். Planka-வை https://example.com/planka போன்ற subpath-லிருந்து இயக்குவது, மார்ச் 2026-ல் வெளியான 2.1.0 பதிப்பிலிருந்து சாத்தியமாகும். பழைய tags-க்கு, அதற்குத் தனி subdomain-ஐப் பயன்படுத்தவும்.

Planka இணைப்புகள் மற்றும் அவதாரங்களை எங்கு சேமிக்கிறது

Planka 2, பயனர் பதிவேற்றும் அனைத்தையும் container-க்குள் ஒரே பாதையில் சேமிக்கிறது: /app/data. இணைப்புகள், பயனர் அவதாரங்கள் மற்றும் board background படங்கள் அனைத்தும் இதற்குக் கீழேதான் இருக்கும். பதிப்பு 1-ல் மூன்று தனித்தனி directories பயன்படுத்தப்பட்டன, எனவே பழைய கட்டுரைகளில் இருந்து நகலெடுக்கப்பட்ட Compose கோப்பு தற்போது இல்லாத பாதைகளை mount செய்யக்கூடும், இதனால் தரவு mount விடுபட்டுவிடும்.

அந்த ஒற்றை mount-தான், ஒரு upgrade-க்குப் பிறகும் board பாதுகாப்பாக இருப்பதற்கும், தரவு இழப்பு ஏற்படுவதற்கும் உள்ள வித்தியாசமாகும். Docker image /app/data-ஐ ஒரு volume-ஆக அறிவிக்கிறது, எனவே Compose-ல் அந்த mount-ஐத் தவிர்த்தால், பதிவேற்றங்கள் ஒரு anonymous volume-ல் சேமிக்கப்படும். சாதாரண up மறுஉருவாக்கத்தின் போது Compose அதைத் தக்கவைக்கும், ஆனால் அதன் பிறகு செய்யப்படும் down மற்றும் அதைத் தொடர்ந்து வரும் up ஆகியவை அதைத் தானாகவே மீண்டும் இணைக்காது. Board பார்ப்பதற்குச் சரியாகத் தெரியும், cards அனைத்தும் இருக்கும், ஆனால் ஒவ்வொரு இணைப்பு இணைப்பும் (attachment link) வேலை செய்யாது, ஏனெனில் database வரிசைகள் இன்னும் பழைய volume-ல் உள்ள கோப்புகளையே சுட்டிக்காட்டும்.

மேலே உள்ள Compose கோப்பில் உள்ள named volume இதைத் தடுக்கிறது. ஒரு bind mount-ம் வேலை செய்யும், மேலும் சாதாரண கருவிகளைக் கொண்டு கோப்புகளை backup எடுப்பதை எளிதாக்கும், ஆனால் அதற்கு ஒரு கூடுதல் படி தேவை. Container-க்குள் இருக்கும் Node process UID 1000-ஆக இயங்குகிறது, எனவே root-க்குச் சொந்தமான host directory-ல் முதல் பதிவேற்றத்தின் போது அனுமதிப் பிழை (permission error) ஏற்படும்:

sudo chown -R 1000:1000 /opt/planka/data

இவ்விரண்டிற்கும் இடையிலான வேறுபாடுகள் bind mounts மற்றும் named volumes பகுதியில் விளக்கப்பட்டுள்ளன.

உங்கள் திட்டத்தில் இணைப்புகள் disk அளவை விட அதிகரித்தால், S3_ENDPOINT, S3_BUCKET மற்றும் அதற்கேற்ற key variables மூலம் Planka அவற்றை S3-compatible சேமிப்பகத்தில் எழுத முடியும். இது ஒரு hosted bucket-ஐ அல்லது மற்றொரு பெட்டியில் உள்ள self-hosted MinIO object store-ஐச் சுட்டிக்காட்டலாம். குழுவினர் board-ஐப் பயன்படுத்துவதற்கு முன்பே இதை முடிவு செய்யுங்கள், ஏனெனில் S3-ஐ இயக்குவது ஏற்கனவே உள்ள பதிவேற்றங்களை மாற்றாமல், கோப்பு வாசிப்பு மற்றும் எழுதுதலை அந்த backend-க்கு மாற்றிவிடும்.

Stack-ஐத் தொடங்கி அது சரியாக இயங்குகிறதா எனச் சரிபார்த்தல்

docker compose pull
docker compose up -d
docker compose ps

docker compose ps-ஐ இயக்கும்போது postgres என்பது healthy என்றும், planka என்பது running என்றும் காட்ட வேண்டும். Planka தொடர்ந்து restart ஆகிக்கொண்டிருந்தால், application-ஐப் பார்ப்பதற்கு முன்னால் database connection-ஐச் சரிபார்க்க வேண்டும்.

docker compose logs -f planka

சரியான முறையில் முதல்முறை boot ஆகும்போது database migrations தானாகவே நடக்கும். ஆனால், production configuration-ல் noShip: true அமைக்கப்பட்டிருப்பதால், port 1337-ல் இயங்குவதாகக் காட்டும் startup செய்தி வராது. எனவே, log-ஐ மட்டும் நம்பாமல், Postgres-இடம் நேரடியாகக் கேட்டு schema சரியாகப் பதிவாகியுள்ளதா என்பதை உறுதிப்படுத்தவும்:

docker compose exec postgres psql -U planka -d planka -c '\dt'

board மற்றும் card ஆகியவற்றை உள்ளடக்கிய table பட்டியல் கிடைத்தால், migrations சரியாக நடந்துள்ளது என்று அர்த்தம். "Did not find any relations" என்று வந்தால், Planka-வால் database-உடன் இணைய முடியவில்லை என்று பொருள். எனவே, உங்கள் .env-ல் உள்ள POSTGRES_USER மற்றும் POSTGRES_PASSWORD மதிப்புகளுடன் DATABASE_URL-ஐ ஒப்பிட்டுச் சரிபார்க்கவும்.

அதன்பிறகு, VPS-லிருந்து அல்லாமல், உங்கள் சொந்த கணினியிலிருந்து அந்த route-ஐச் சரிபார்க்கவும்:

curl -I https://kanban.example.com

HTTP/2 200 என்பது Traefik ஒரு certificate-ஐ வைத்துக்கொண்டு container-ஐ அடைகிறது என்பதைக் குறிக்கிறது. Traefik-லிருந்து 404 பிழை வந்தால், எந்த router-உம் அந்த request-உடன் பொருந்தவில்லை என்று அர்த்தம்: நீங்கள் கேட்ட hostname-உடன் Host() விதி பொருந்தவில்லை அல்லது Traefik அந்த labels-ஐ எடுத்துக்கொள்ளவில்லை. 502 பிழை வந்தால், router பொருந்துகிறது ஆனால் Traefik-ஆல் container-ஐ அடைய முடியவில்லை என்று அர்த்தம்; உதாரணமாக, அது proxy network-உடன் இணைக்கப்படாமல் இருக்கலாம். இப்போது தளத்தைத் திறந்து admin account மூலம் login செய்யவும்.

ஒவ்வொரு version மாற்றத்திற்கு முன்பும் pg_dump எடுக்கவும்

உங்கள் board-ஐ இரண்டு தனித்தனி சேமிப்பகங்கள் கொண்டுள்ளன, எனவே backup என்பது இரண்டையும் உள்ளடக்கியதாக இருக்க வேண்டும்: Postgres database மற்றும் planka-data volume. stack இயங்கிக்கொண்டிருக்கும்போதே database-ஐ dump செய்யவும்.

docker compose exec -T postgres pg_dump -U planka -d planka > "planka-db-$(date +%F).sql"

-T என்பது Compose-ன் இயல்புநிலை pseudo-terminal ஒதுக்கீட்டை முடக்குகிறது, இது dump-ஐ ஒரு plain output stream-ல் வைத்திருக்கும்.

அடுத்து uploads. முதலில் உண்மையான volume பெயரை கண்டறியவும், ஏனெனில் Compose அதை project directory பெயருடன் முன்னொட்டாக (prefix) சேர்க்கும்.

docker volume ls | grep planka
docker run --rm -v planka_planka-data:/data -v "$PWD":/backup alpine \
  tar czf /backup/planka-files-$(date +%F).tgz -C /data .

இந்த project அதன் repository-ல் docker-backup.sh மற்றும் docker-restore.sh ஆகியவற்றை வழங்குகிறது, மேலும் அதிகாரப்பூர்வ ஆவணங்கள் அவற்றை nightly cron job-ல் வைக்க பரிந்துரைக்கின்றன. எந்த அணுகுமுறையும் சரிதான். நீங்கள் ஒருபோதும் restore செய்து பார்க்காத backup மட்டும் சரியாக இருக்காது, எனவே ஒருமுறை scratch VPS-ல் restore செய்து, உங்களால் login செய்ய முடிகிறதா மற்றும் attachment-ஐ திறக்க முடிகிறதா என்பதை உறுதிப்படுத்தவும். uploads-ஐ ஏற்கும் ஒவ்வொரு Compose app-லும் இதே போன்ற இரண்டு சேமிப்பகங்கள் இருக்கும், எனவே நீங்கள் பிற்காலத்தில் உங்கள் support desk இருக்கும் அதே server-ல் Chatwoot-ஐ நிறுவினால், நீங்கள் இங்கே உருவாக்கும் நடைமுறை, volume பெயர்களை மட்டும் மாற்றினால் போதுமானதாக இருக்கும்.

ஒவ்வொரு version மாற்றத்திற்கு முன்பும் உடனடியாக dump-ஐ இயக்கவும். நேற்று இரவு எடுக்கப்பட்ட backup என்பது, நீங்கள் செய்யப்போகும் migration-க்கு முன்பு எடுக்கப்பட்ட backup-க்கு சமமானது அல்ல.

Tags-ஐ நிலைநிறுத்துதல் மற்றும் release notes-ஐ வாசித்தல்

அந்தக் கோப்பில் உள்ள இரண்டு image tags-உம் வேண்டுமென்றே குறிப்பிட்ட பதிப்பில் நிலைநிறுத்தப்பட்டுள்ளன (pinned).

ghcr.io/plankanban/planka:2.2.1 என்பது அக்டோபர் 2026 நிலவரப்படி ஒரு குறிப்பிட்ட release ஆகும். Community 2.3.0 பதிப்பு நவம்பர் 4, 2026 அன்று பாதுகாப்புத் திருத்தங்களுடன் வெளியானது, அதை மேம்படுத்த upstream பரிந்துரைக்கிறது. Community 2.3.1 பதிப்பு நவம்பர் 5, 2026 அன்று வெளியானது; இது username இல்லாத உறுப்பினர்களைக் கொண்ட boards-ல் card descriptions-ஐத் திருத்தும்போது ஏற்படும் crash-ஐச் சரிசெய்கிறது. latest என்பது upstream புதிய பதிப்பை வெளியிடும்போதெல்லாம் மாறும், எனவே ஒரு சாதாரண docker compose pull கட்டளை நீங்கள் எதிர்பாராத நேரத்தில் schema migration-ஐ ஏற்படுத்தக்கூடும். அந்த எண்ணை மாற்றுவதற்கு முன் release notes-ஐ வாசிக்கவும், ஏனெனில் முக்கியமான மாற்றங்கள் மற்றும் பாதுகாப்புத் திருத்தங்கள் அங்குதான் விவரிக்கப்பட்டிருக்கும். பதிப்பு 2.0.3 ஒரு பாதுகாப்பு வெளியீடாக வந்தது, இது போன்ற தகவல்களைத் தற்செயலாகப் பெறுவதை விட வாசிப்பதே சிறந்தது. ஆகஸ்ட் 2026-ல் வெளியான 2.2.1 பதிப்பும் அப்படித்தான்; இது local file storage-ஐப் பயன்படுத்தும் instances-ல், login செய்த பயனர் தன்னிச்சையான கோப்புகளைப் படிக்க அனுமதிக்கும் path traversal பிழையைச் சரிசெய்தது. இந்த வழிகாட்டியில் அத்தகைய அமைப்புதான் பயன்படுத்தப்படுகிறது, மேலும் 2.1.1 மற்றும் அதற்கு முந்தைய பதிப்புகள் பாதிக்கப்படக்கூடியவை என்று அந்த advisory குறிப்பிடுகிறது. நீங்கள் 2.1.x பதிப்பிலிருந்து வருகிறீர்கள் என்றால், முதலில் 2.2.0 குறிப்புகளை வாசிக்கவும், ஏனெனில் அந்த வெளியீடு SSO மூலம் மட்டுமே login செய்த பயனர்களை, admin அவர்களுக்கு password வழங்கி மீண்டும் active செய்யும் வரை முடக்கிவிடும். Upstream நிறுவனங்கள் image-களை வெளியிடுவதால் இங்கே pinning செய்வது எளிது. ஒரு project எந்த image-உம் வழங்கவில்லை என்றால், நீங்கள் அதே கவனத்துடன் செயல்பட வேண்டும், உதாரணமாக git tag-லிருந்து நேரடியாக build செய்யப்பட்ட openGym.

postgres:16-alpine ஒரு முக்கிய பதிப்பில் (major version) நிலைநிறுத்தப்பட்டுள்ளது, அதற்கு ஒரு வலுவான காரணம் உள்ளது. Postgres தனது data directory-ஐ அந்த major version-க்கு உரிய வடிவத்தில் எழுதுகிறது, எனவே வேறொரு பதிப்பில் எழுதப்பட்ட directory-ஐத் திறக்க server மறுத்துவிடும். postgres:latest என்று எழுதி, tag 16-ஐத் தாண்டிச் சென்றால், container தொடங்காது. உதாரணமாக, 17 image பின்வரும் பிழையுடன் நின்றுவிடும்:

FATAL:  database files are incompatible with server
DETAIL:  The data directory was initialized by PostgreSQL version 16, which is not compatible with this version 17.

எதுவும் இழக்கப்படவில்லை, restart செய்வதால் எதுவும் சரியாகப்போவதும் இல்லை. புதிய Postgres major பதிப்பிற்கு மாறுவது என்பது பழைய பதிப்பிலிருந்து dump எடுத்து, புதிய பதிப்பில் உள்ள காலியான data directory-ல் restore செய்வதாகும். அல்லது pg_upgrade கட்டளையைப் பயன்படுத்தி, dump எடுக்காமலேயே தரவை மாற்றலாம், ஆனால் அதற்கு பழைய மற்றும் புதிய server binaries இரண்டும் ஒரே நேரத்தில் தேவைப்படும். அல்லது புதிய பதிப்பில் இயங்கும் server-க்கு logical replication செய்துவிட்டு, பின்னர் switchover செய்யலாம். ஒவ்வொரு முறையும் இது ஒரு திட்டமிடப்பட்ட migration ஆகும், image pull செய்வதால் ஏற்படும் பக்கவிளைவு அல்ல. Logical replication முறையில், புதிய server தயாராகும் வரை பழைய server தொடர்ந்து இயங்கிக்கொண்டிருக்கும்.

நீங்கள் புதிதாகத் தொடங்காமல், ஏற்கனவே உள்ள Planka 1.x install-ஐ மாற்றுகிறீர்கள் என்றால், அந்த மேம்படுத்தலுக்கு project documentation-ல் தனிப்பட்ட நடைமுறை உள்ளது. முன்னரே backup எடுக்காமல் பதிப்பு 1-க்குத் திரும்புவதற்கு வழியே இல்லை.

தோல்வி முறைகள் மற்றும் நீங்கள் காணக்கூடிய செய்திகள்

Planka மீண்டும் மீண்டும் restart ஆகிறது மற்றும் log-ல் database பற்றிய பிழை உள்ளது. DATABASE_URL-ல் உள்ள நற்சான்றிதழ்கள் (credentials) Postgres சூழலுடன் பொருந்தவில்லை. POSTGRES_PASSWORD என்பது தரவு அடைவு (data directory) முதன்முதலில் உருவாக்கப்படும்போது மட்டுமே பயன்படுத்தப்படும் என்பதை கவனத்தில் கொள்க. எனவே, முதல்முறை தவறாக boot ஆன பிறகு இந்த மாறியை (variable) மாற்றினால் எந்த மாற்றமும் இருக்காது. கட்டமைக்கப்பட்ட கடவுச்சொல்லுடன் பொருந்த, ALTER ROLE-ஐப் பயன்படுத்தி database role-ன் கடவுச்சொல்லை மாற்றவும்; db-data volume-ஐ நீக்குவது தரவு எதையும் வைத்திருக்கத் தேவையில்லாத தற்காலிக நிறுவல்களுக்கு மட்டுமே பொருந்தும்.

Login வெற்றிகரமாக முடிகிறது ஆனால் board ஏற்றப்படவில்லை. BASE_URL என்பது browser முகவரிப் பட்டியில் உள்ள முகவரியுடன் பொருந்தவில்லை, எனவே server அந்த socket-ன் origin-ஐ நிராகரிக்கிறது. Browser console-ல் /socket.io/-க்கான கோரிக்கைகள் தோல்வியடைவதைக் காணலாம்.

மற்ற அனைத்தும் சரியாக வேலை செய்கிறது, ஆனால் கோப்புகளை upload செய்ய முடியவில்லை. Bind mount-ன் உரிமை root வசம் உள்ளது. Host அடைவில் sudo chown -R 1000:1000-ஐ இயக்கி, container-ஐ restart செய்யவும்.

Upgrade செய்த பிறகு இணைப்புகள் (attachments) காணவில்லை. /app/data அசல் uploads volume-உடன் இணைக்கப்படவில்லை. அந்த volume-ஐ மீண்டும் இணைக்கவும் அல்லது backup-லிருந்து கோப்புகளை மீட்டெடுக்கவும். பிறகு, image tag-ஐ மாற்றுவதற்கு முன் named volume-ஐப் பயன்படுத்தவும்.

Traefik 404 பிழையைத் தருகிறது. கோரிக்கையுடன் எந்த router-ம் பொருந்தவில்லை: Host() விதி உங்கள் DNS பதிவுடன் பொருந்தவில்லை அல்லது labels Traefik-ஐச் சென்றடையவில்லை. docker compose config என்பது மாற்றீடுகளுக்குப் பிறகு labels-ஐக் காட்டுகிறது, அங்குதான் தட்டச்சுப் பிழைகளை (typos) கண்டறிய முடியும். 502 பிழை என்பது பாதை சரியாக உள்ளது, ஆனால் container-ஐ அணுக முடியவில்லை என்று பொருள்; எனவே அது proxy network-ல் உள்ளதா என்பதைச் சரிபார்க்கவும்.

அறிவிப்புகள் (notifications) அல்லது webhooks வரவில்லை. Planka 2 தனது வெளிச்செல்லும் HTTP கோரிக்கைகளை ஒரு internal filter வழியாக அனுப்புகிறது, மேலும் இயல்புநிலை தடுப்புப் பட்டியலில் (block list) localhost மற்றும் postgres உள்ளன. localhost-ஐ நோக்கிய webhook வடிவமைப்பிலேயே தடுக்கப்படுகிறது, மேலும் நீங்கள் OUTGOING_ALLOWED_HOSTS-ஐ அமைத்தவுடன், அந்தப் பட்டியலில் இல்லாத அனைத்து host-களும் தடுக்கப்படும். Webhook-ஐ மற்ற container-ன் service பெயருக்கு மாற்றவும், நீங்கள் allow list பயன்படுத்தினால், filter-ஐ நீக்குவதற்குப் பதிலாக அந்தப் பெயரை OUTGOING_ALLOWED_HOSTS-ல் சேர்க்கவும்.

ஒருமுறை இயங்கத் தொடங்கிய பிறகு, இதன் செயல்பாட்டுச் சுமை (operational load) மிகக் குறைவு. Release notes-ஐக் கவனியுங்கள், ஒவ்வொரு upgrade-க்கு முன்பும் database-ஐ dump செய்யவும். restart: unless-stopped காரணமாக, ஒரு reboot-க்குப் பிறகு stack தானாகவே மீண்டும் இயங்கும். Docker service-ம் boot-ன் போது enabled நிலையில் இருப்பதை உறுதி செய்யவும். Reboot-க்குப் பிறகு மீண்டும் தொடங்கும் Compose stacks என்பது இது செயல்படாத சூழல்களைப் பற்றி விளக்குகிறது.

FAQ

Planka-வில் உள்நுழைந்த பிறகு ஏன் அது தொடர்ந்து லோட் ஆகிக்கொண்டே இருக்கிறது?

உங்கள் நற்சான்றிதழ்கள் (credentials) ஏற்கப்பட்டுவிட்டன, ஆனால் நேரடி இணைப்பு (live connection) ஏற்படவில்லை. உலாவி பக்கத்தின் origin-க்கு அதன் socket-ஐத் திறக்கிறது, ஆனால் Planka தனது அனுமதிக்கப்பட்ட socket origins-ஐ BASE_URL-லிருந்து பெறுகிறது. எனவே, நீங்கள் https://kanban.example.com மூலம் தளத்தை அணுகும்போது அந்த variable-ஐ http://localhost:3000-லேயே வைத்திருப்பது, சர்வர் இணைப்பை நிராகரிக்கக் காரணமாகிறது. டெவலப்பர் கன்சோலில் /socket.io/-க்கான கோரிக்கைகள் தோல்வியடைவதைக் காணலாம். BASE_URL-ஐ எந்த trailing slash-ம் இல்லாமல் சரியான பொது முகவரிக்கு (public address) அமைக்கவும். உங்கள் reverse proxy-யிலிருந்து வரும் X-Forwarded-Proto header-ஐ ஆப் அங்கீகரிக்க TRUST_PROXY=true-ஐச் சேர்க்கவும். பின்னர் docker compose up -d-ஐ இயக்கவும்.

முதல் Planka நிர்வாகி பயனரை (admin user) எவ்வாறு உருவாக்குவது?

பதிப்பு 1.13 முதல், நிர்வாகி தானாகவே உருவாக்கப்படுவதில்லை. DEFAULT_ADMIN_EMAIL-ஐ அதற்கேற்ற கடவுச்சொல், பெயர் மற்றும் பயனர் பெயர் மாறிகளுடன் அமைத்து stack-ஐத் தொடங்கலாம், அல்லது docker compose run --rm planka npm run db:create-admin-user-ஐ இயக்கி கேட்கப்படும் கேள்விகளுக்குப் பதிலளிக்கலாம். பகிரப்பட்ட சர்வரில் இந்த interactive கட்டளையைப் பயன்படுத்துவது பாதுகாப்பானது, ஏனெனில் கடவுச்சொல் கன்டெய்னரின் கட்டமைக்கப்பட்ட சூழலுக்குள் (configured environment) செல்லாது, அங்கு docker inspect அதை வாசிக்க முடியாது. அமைத்த பிறகு DEFAULT_ADMIN_EMAIL-ஐ அப்படியே வைத்திருப்பது, அந்த கணக்கின் பெயர், பங்கு மற்றும் மின்னஞ்சல் முகவரியை மாற்றுவதைத் தடுக்கிறது, மேலும் இடைமுகத்திலிருந்து அதை நீக்குவதையும் தடுக்கிறது. அமைப்பிற்குப் பிறகு DEFAULT_ADMIN_PASSWORD-ஐ நீக்கிவிடவும், ஏனெனில் அதை வைத்திருப்பது ஒவ்வொரு தொடக்கத்தின்போதும் அந்த கணக்கின் கடவுச்சொல்லை மீண்டும் அமைத்துவிடும் (reset).

Planka இணைப்புகள் (attachments) மற்றும் அவதாரங்களை (avatars) எங்கே சேமிக்கிறது?

Planka 2-ல், பதிவேற்றப்பட்ட அனைத்து கோப்புகளும் கன்டெய்னருக்குள் /app/data-க்கு அடியில் சேமிக்கப்படுகின்றன. இதில் இணைப்புகள், பயனர் அவதாரங்கள் மற்றும் போர்டு பின்னணிகள் அடங்கும். அந்தப் பாதையை ஒரு named volume-ல் mount செய்யவும். வெளிப்படையான mount இல்லையென்றால், Docker image ஒரு anonymous volume-ஐப் பயன்படுத்தும், இது docker compose down-க்குப் பிறகு docker compose up மூலம் தானாகவே மீண்டும் இணைக்கப்படாது. Bind mount-ம் வேலை செய்யும், ஆனால் Node process UID 1000-ஆக இயங்குவதால், ஹோஸ்ட் டைரக்டரியில் sudo chown -R 1000:1000-ஐ இயக்கவும், இல்லையெனில் அனுமதிப் பிழையால் (permission error) பதிவேற்றங்கள் தோல்வியடையும்.

சுய-ஹோஸ்ட் செய்யப்பட்ட Planka-விற்கு எவ்வளவு RAM தேவை?

திட்டத்தின் தொழில்நுட்ப FAQ, சிறிய குழுக்களுக்கு குறைந்தபட்சம் 2 GB RAM மற்றும் 10 GB சேமிப்பகத்தைப் பரிந்துரைக்கிறது. இயல்புநிலை Docker deployment ஒரு Node process, ஒவ்வொரு திறந்த இணைப்பிற்கும் ஒரு backend process கொண்ட Postgres சர்வர் மற்றும் வெளிச்செல்லும் கோரிக்கைகளை வடிகட்ட ஒரு உள் Squid proxy ஆகியவற்றை இயக்குகிறது. ஒரு சாதாரண வாரத்திற்குப் பிறகு docker stats --no-stream-ஐ இயக்கி, உங்கள் சொந்த எண்களின் அடிப்படையில் அளவை முடிவு செய்யவும். நினைவகத்தை விட வட்டை (disk) உன்னிப்பாகக் கவனிக்கவும், ஏனெனில் இணைப்புகள் தான் அதிக இடத்தை எடுத்துக்கொள்ளும்.

தரவு இழப்பின்றி Planka-வை எவ்வாறு மேம்படுத்துவது (upgrade)?

மேம்படுத்துவதற்குச் சற்று முன்பு தரவுத்தளத்தை டம்பிங் (dump) செய்யவும் மற்றும் பதிவேற்றங்கள் உள்ள volume-ஐ ஆவணப்படுத்தவும் (archive); முந்தைய நாள் இரவு அட்டவணையை நம்பியிருக்க வேண்டாம். docker compose exec -T postgres pg_dump -U planka -d planka > planka-db.sql-ஐப் பயன்படுத்தவும், திசைதிருப்பப்பட்ட வெளியீட்டிற்கு (redirected output) pseudo-terminal ஒதுக்கீட்டை முடக்க -T-ஐ வைத்திருக்கவும். நீங்கள் தவிர்க்கும் ஒவ்வொரு பதிப்பிற்கான வெளியீட்டுக் குறிப்புகளையும் (release notes) படிக்கவும். image tag-ஐ latest-க்கு பதிலாக ஒரு குறிப்பிட்ட பதிப்பிற்கு மாற்றவும், பின்னர் docker compose pull மற்றும் docker compose up -d-ஐ இயக்கி, migration-ஐக் கண்காணிக்கவும். Postgres tag-ஐ அதன் major பதிப்பிலேயே வைத்திருக்கவும், ஏனெனில் வெவ்வேறு major பதிப்பால் எழுதப்பட்ட தரவு டைரக்டரியை சர்வர் திறக்க மறுத்துவிடும்.

இந்தக் கட்டுரை பயனுள்ளதாக இருந்ததா?