SSD Nodes Learn Hosting plans →
คู่มือ Matt Connorโดย Matt Connor

วิธีติดตั้ง Planka บน Docker Compose พร้อมตั้งค่า Traefik

เรียนรู้วิธีติดตั้ง Planka บน VPS ด้วย Docker Compose พร้อมเชื่อมต่อ Postgres และ Traefik ครบจบในที่เดียว รวมถึงวิธีตั้งค่า BASE_URL ให้ถูกต้องเพื่อป้องกันปัญหาการล็อกอิน

สิ่งที่คุณจะได้รับจากการ self-host Planka

การ self-host Planka ช่วยให้ทีมของคุณมีกระดาน Kanban ที่ใช้โมเดลการ์ด รายการ และป้ายกำกับแบบเดียวกับที่คุ้นเคยใน Trello โดยทำงานบน VPS ที่คุณควบคุมเอง คุณจะไม่มีข้อจำกัดเรื่องจำนวนที่นั่งและไม่มีการเรียกเก็บเงินรายผู้ใช้ เนื่องจากค่าใช้จ่ายเดียวคือค่าเช่าเซิร์ฟเวอร์ คู่มือนี้จะแนะนำการติดตั้งด้วย Docker Compose โดยมี Traefik เป็น reverse proxy ใช้ Postgres สำหรับจัดเก็บข้อมูล และใช้ named volume สำหรับไฟล์ทุกไฟล์ที่ผู้ใช้อัปโหลด

Planka 2 เผยแพร่ภายใต้ Fair Use License ของโครงการเอง ซึ่งทางโครงการระบุว่าเป็นซอฟต์แวร์แบบ source-available ไม่ใช่ open source คุณสามารถใช้งานเพื่อโครงการภายในองค์กรของคุณเองได้ แต่หากต้องการนำไปให้บริการเป็น commercial hosted service แก่บุคคลภายนอก จำเป็นต้องมีใบอนุญาตแบบ Pro หรือ Enterprise

ผู้อ่านที่คู่มือนี้มุ่งเน้นคือทีมขนาด 2 ถึง 5 คนที่กำลังย้ายออกจาก Trello รุ่นฟรี หากคุณยังตัดสินใจไม่ได้ว่าจะเลือกใช้กระดานตัวไหน ให้ลองอ่าน การเปรียบเทียบทางเลือก Trello แบบ self-hosted ก่อน คู่มือนี้ถือว่าคุณได้ตัดสินใจเลือกแล้วและจะครอบคลุมเฉพาะขั้นตอนการติดตั้งเท่านั้น

คุณจำเป็นต้องมี VPS ที่ติดตั้ง Docker Engine พร้อม Compose plugin และมี DNS A record ชี้มายัง VPS นั้น นอกจากนี้คุณต้องมี Traefik ที่ทำ TLS termination (transport layer security) อยู่บนเซิร์ฟเวอร์นั้นแล้ว หากคุณยังไม่มี Traefik ให้ตั้งค่า Traefik reverse proxy สำหรับแอป Docker Compose หลายตัว ก่อน และอ่าน พื้นฐาน Docker Compose สำหรับ VPS หากไฟล์ด้านล่างนี้ดูไม่คุ้นเคย

Planka ต้องการ VPS ขนาดเท่าใด

FAQ ทางเทคนิคของโปรเจกต์แนะนำให้ใช้ RAM อย่างน้อย 2 GB และพื้นที่จัดเก็บข้อมูล 10 GB สำหรับทีมขนาดเล็ก ดังนั้นให้ถือว่าตัวเลขเหล่านี้เป็นจุดเริ่มต้นมากกว่าจะเป็นค่ามาตรฐานที่ตายตัว

สิ่งที่ทำงานจริงมีขนาดเล็ก ได้แก่ กระบวนการ Node.js หนึ่งรายการที่ให้บริการ API และ frontend ที่ build ไว้แล้ว รวมถึงเซิร์ฟเวอร์ Postgres ที่เก็บข้อมูล ซึ่งจะรันกระบวนการควบคุม (supervising process) และกระบวนการ backend หนึ่งรายการต่อการเชื่อมต่อที่เปิดอยู่ นอกจากนี้ยังมีกระบวนการ proxy ขนาดเล็กทำงานอยู่ภายในคอนเทนเนอร์ Planka เพื่อกรองคำขอขาออก แผนการใช้งานขนาด 2 GB สอดคล้องกับคำแนะนำด้าน RAM ของโปรเจกต์สำหรับทีมขนาดเล็ก บอร์ดเป็นแอปพลิเคชันที่ใช้ทรัพยากรน้อย ดังนั้นหาก VPS เดียวกันนี้ต้องใช้เก็บเอกสารของทีมด้วย ให้พิจารณาขนาดของแอปนั้นก่อน: การรัน AFFiNE เป็นพื้นที่ทำงานสไตล์ Notion ต้องการ RAM อีกสองสามกิกะไบต์แยกต่างหากก่อนที่ Planka จะเริ่มใช้งาน

ให้กำหนดขนาดดิสก์ก่อนกำหนดขนาดหน่วยความจำ เนื่องจากไฟล์แนบคือส่วนที่จะเพิ่มขนาดขึ้นเรื่อยๆ ให้วัดค่าจากอินสแตนซ์ของคุณเองแทนที่จะเชื่อถือย่อหน้านี้เพียงอย่างเดียว:

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

คำสั่งแรกจะแสดงหน่วยความจำและ CPU ที่ใช้งานจริงต่อคอนเทนเนอร์ ส่วนคำสั่งที่สองจะแสดงพื้นที่ที่แต่ละ volume ใช้งานอยู่ ให้เก็บค่าทั้งสองรายการหลังจากผ่านสัปดาห์การทำงานปกติไปแล้ว ไม่ใช่ในวันที่ติดตั้ง เพราะบอร์ดที่ไม่มีการใช้งานจะไม่บอกข้อมูลอะไรเกี่ยวกับทีมของคุณเลย

เขียนไฟล์ Compose

สร้างไดเรกทอรีและกำหนดสิทธิ์ความเป็นเจ้าของ เพื่อให้คุณไม่ต้องแก้ไขไฟล์เหล่านี้ผ่าน sudo อีกต่อไป

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

สร้างข้อมูลลับลงในไฟล์ .env ไว้ข้างไฟล์ Compose โดย 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 เป็นความตั้งใจ เพราะสตริงเลขฐานสิบหกประกอบด้วยตัวเลขและตัวอักษร a ถึง f เท่านั้น จึงไม่ทำให้ connection string ของ DATABASE_URL ที่นำไปวางเกิดข้อผิดพลาด ในขณะที่ Base64 มาตรฐานอาจมีเครื่องหมายทับ เครื่องหมายบวก และเครื่องหมายเท่ากับ แต่ไม่มีเครื่องหมาย at sign ซึ่งอักขระที่มีความหมายพิเศษใน URL ของการเชื่อมต่อจำเป็นต้องใช้การเข้ารหัสแบบ percent-encoding รูปแบบที่ครอบคลุมกว่านี้อยู่ใน การเก็บข้อมูลลับไว้นอกไฟล์ Compose

ตอนนี้ให้ใช้ docker-compose.yml โดยแทนที่ kanban.example.com ด้วยชื่อโฮสต์ของคุณในทั้งสองตำแหน่งที่ปรากฏ

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:

การตัดสินใจสี่ประการในไฟล์นั้นควรค่าแก่การอธิบาย เนื่องจากเป็นจุดที่ผู้ใช้มักเปลี่ยนแล้วเกิดปัญหาในภายหลัง

  • ไม่มีบล็อก ports: ในบริการ Planka เนื่องจาก Traefik เข้าถึงคอนเทนเนอร์ผ่านเครือข่าย proxy ดังนั้นพอร์ต 1337 จึงไม่ถูกเผยแพร่ออกสู่โฮสต์ การเผยแพร่พอร์ตดังกล่าวจะเปิดช่องทางให้ผู้อื่นเลี่ยง proxy และใบรับรองของคุณได้
  • loadbalancer.server.port=1337 ระบุพอร์ตภายในคอนเทนเนอร์ โดย Planka ฟังที่พอร์ต 1337 แต่ตัวอย่าง upstream ทั่วไปจะเข้าถึงที่พอร์ต 3000 เพราะมีการแมปพอร์ตไปยังโฮสต์ ในที่นี้ไม่มีการแมปโฮสต์ จึงต้องระบุพอร์ตคอนเทนเนอร์ให้ Traefik ทราบ
  • condition: service_healthy ทำงานร่วมกับ healthcheck ของ Postgres หากไม่มีส่วนนี้ Planka จะเริ่มทำงานก่อนที่ฐานข้อมูลจะพร้อมรับการเชื่อมต่อ ทำให้ query แรกล้มเหลวและโปรแกรมหยุดทำงาน ซึ่งดูเหมือนอาการ crash loop กลไกการทำงานอยู่ใน การตรวจสอบสถานะและการจัดลำดับการเริ่มทำงานของ Compose
  • บริการฐานข้อมูลถูกตั้งชื่อว่า postgres โดยเจตนา เนื่องจาก Planka 2 จะส่งคำขอขาออกผ่านตัวกรองภายในซึ่งมีรายการบล็อกเริ่มต้นคือ localhost,postgres หากคุณเปลี่ยนชื่อบริการ คุณจะนำฐานข้อมูลของคุณออกจากรายการดังกล่าวโดยไม่รู้ตัว

ตรวจสอบว่า Compose มองเห็นข้อมูลลับของคุณก่อนที่จะเริ่มดำเนินการใดๆ:

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

คำสั่งนี้จะแสดงไฟล์ที่มีการแทนที่ค่า .env เรียบร้อยแล้ว หากค่าว่างเปล่าแสดงว่า Compose ไม่ได้อ่านไฟล์ .env ซึ่งมักเกิดจากการที่คุณรันคำสั่งจากไดเรกทอรีอื่น

การทำงานของตัวแปร bootstrap สำหรับผู้ดูแลระบบ

ตั้งแต่ Planka เวอร์ชัน 1.13 เป็นต้นมา ระบบจะไม่มีการสร้างบัญชีผู้ดูแลระบบให้โดยอัตโนมัติ ดังนั้นฐานข้อมูลที่เพิ่งติดตั้งใหม่จึงไม่มีผู้ใช้งานที่สามารถเข้าสู่ระบบได้ กลุ่มตัวแปร DEFAULT_ADMIN_* เป็นหนึ่งในสองวิธีในการแก้ไขปัญหานี้

เมื่อเริ่มต้นระบบ Planka จะตรวจสอบว่ามีผู้ใช้งานที่ตรงกับ DEFAULT_ADMIN_EMAIL หรือไม่ หากไม่มี ระบบจะสร้างบัญชีขึ้นมาใหม่โดยใช้รหัสผ่าน ชื่อที่แสดง และชื่อผู้ใช้งานที่กำหนดไว้ควบคู่กัน ในการเริ่มต้นระบบครั้งถัดไป ระบบจะอัปเดตบัญชีที่ตรงกันจากตัวแปรเหล่านี้ รวมถึงการรีเซ็ตรหัสผ่านหาก DEFAULT_ADMIN_PASSWORD ยังคงถูกตั้งค่าไว้

DEFAULT_ADMIN_EMAIL ทำหน้าที่อีกอย่างหนึ่งที่มักทำให้ผู้ใช้งานสับสน ในขณะที่ตัวแปรนี้ยังคงถูกตั้งค่าอยู่ บัญชีที่ถูกระบุชื่อไว้จะไม่สามารถเปลี่ยนชื่อ บทบาท หรือที่อยู่อีเมล รวมถึงไม่สามารถลบบัญชีผ่านหน้าจออินเทอร์เฟซได้ นี่คือกลไกป้องกันการล็อกเอาต์ และเป็นเหตุผลว่าทำไมคุณจึงไม่สามารถเปลี่ยนชื่อหรืออีเมลของบัญชีนั้นผ่าน UI ได้ หากต้องการแก้ไข ให้ลบตัวแปรดังกล่าวออกแล้วรีสตาร์ทระบบ บัญชีนั้นจะกลายเป็นบัญชีผู้ดูแลระบบทั่วไปที่คุณสามารถแก้ไขได้เหมือนบัญชีอื่น

บรรทัดรหัสผ่านเป็นส่วนที่ต้องระมัดระวังเป็นพิเศษ ข้อมูลใดๆ ภายใต้ environment: สามารถอ่านได้โดยทุกคนที่สามารถรันคำสั่ง docker inspect บนคอนเทนเนอร์ได้ ดังนั้น DEFAULT_ADMIN_PASSWORD จึงไม่ควรถูกเก็บไว้ในนั้นอย่างถาวร ให้คุณเข้าสู่ระบบ ลบบรรทัดดังกล่าวออก รันคำสั่ง docker compose up -d อีกครั้ง จากนั้นจึงเปลี่ยนรหัสผ่านของคุณผ่านหน้าจออินเทอร์เฟซ

วิธีที่สะอาดกว่าคือการหลีกเลี่ยงการใช้ตัวแปรเหล่านี้โดยสิ้นเชิง ให้ใส่เครื่องหมายคอมเมนต์ปิดกลุ่ม DEFAULT_ADMIN_* ทั้งหมด จากนั้นสร้างบัญชีผ่านการโต้ตอบด้วยคำสั่ง:

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

ระบบจะถามข้อมูลอีเมล รหัสผ่าน ชื่อที่แสดง และชื่อผู้ใช้งาน (ไม่บังคับ) จากนั้นจะเขียนข้อมูลผู้ใช้ลงในฐานข้อมูลโดยตรง รหัสผ่านจะไม่ถูกบันทึกไว้ในไฟล์ Compose หรือสภาพแวดล้อมที่กำหนดค่าไว้ของคอนเทนเนอร์ ให้ใช้วิธีนี้หากมีผู้ใช้งานมากกว่าหนึ่งคนที่มีสิทธิ์เข้าถึง shell ของ VPS คำสั่งนี้จะเริ่มการทำงานของ Postgres ก่อนเนื่องจาก depends_on ดังนั้นจึงสามารถใช้งานได้แม้ใน stack ที่ยังไม่เคยถูกเปิดใช้งานมาก่อน

ไม่ว่าจะใช้วิธีใด คุณจะต้องจัดการรหัสผ่านของ Planka ด้วยตนเอง จนถึงเวอร์ชัน 2.1.1 รุ่น Community สามารถส่งต่อการเข้าสู่ระบบไปยังผู้ให้บริการ OIDC ได้ เช่น Authentik ที่ทำงานเป็นเซิร์ฟเวอร์ single sign-on ของคุณเอง แต่เวอร์ชัน 2.2.0 ซึ่งปล่อยออกมาในเดือนสิงหาคม 2026 ได้ย้ายฟีเจอร์ OIDC และ SSO ไปไว้ใน PLANKA Pro สิ่งที่รุ่น Community ได้รับในการอัปเดตเดียวกันคือการยืนยันตัวตนสองชั้น (TOTP) สำหรับบัญชีภายใน ดังนั้นควรเปิดใช้งานฟีเจอร์นี้สำหรับบัญชีผู้ดูแลระบบเป็นอย่างน้อย

เหตุใด BASE_URL จึงทำให้การเข้าสู่ระบบล้มเหลวเมื่อไม่ตรงกับชื่อโฮสต์

BASE_URL คือที่อยู่ที่ผู้ใช้พิมพ์ลงในเบราว์เซอร์โดยตรง โดยระบุ scheme และไม่มีเครื่องหมายทับปิดท้าย สำหรับ stack นี้คือ https://kanban.example.com แอป Planka จะสร้างลิงก์ของตนเองและรายการ WebSocket origin ที่อนุญาตจากค่าดังกล่าว ซึ่งหมายความว่าหาก BASE_URL ไม่ถูกต้อง คุณจะไม่ได้รับข้อความแจ้งเตือนข้อผิดพลาดที่ชัดเจน แต่จะพบกับหน้าเว็บที่โหลดค้างอยู่ตลอดเวลา

กรณีที่พบบ่อยคือ คุณคัดลอกตัวอย่างจาก upstream โดยปล่อยให้ BASE_URL=http://localhost:3000 เป็นค่าเดิม แล้วเข้าใช้งานเว็บไซต์ผ่าน HTTPS ด้วยโดเมนจริงของคุณ แบบฟอร์มเข้าสู่ระบบจะส่งข้อมูลและยอมรับข้อมูลประจำตัวของคุณ แต่หน้าบอร์ดจะไม่แสดงผล หากคุณเปิด browser developer console คุณจะเห็นว่าคำขอไปยัง /socket.io/ ล้มเหลว เนื่องจาก socket เชื่อมต่อกับ origin ของหน้าเว็บในเบราว์เซอร์ แต่ข้อจำกัดด้าน origin ของเซิร์ฟเวอร์อนุญาตเฉพาะ origin ที่มาจาก BASE_URL เท่านั้น

TRUST_PROXY=true คืออีกครึ่งหนึ่งของปัญหาเดียวกัน Planka ทำงานอยู่หลัง Traefik ดังนั้นทุกคำขอจะส่งถึงแอปจากที่อยู่ของ proxy ผ่าน HTTP ปกติภายในเครือข่าย Docker หากไม่มี TRUST_PROXY แอปจะเพิกเฉยต่อ header X-Forwarded-Proto และ X-Forwarded-For ที่ Traefik ตั้งค่าไว้ ทำให้แอปเข้าใจว่าการเชื่อมต่อไม่ปลอดภัยและมองว่าไคลเอนต์ทุกรายใช้ IP address เดียวกัน เมื่อตั้งค่านี้แล้ว แอปจะอ่าน header เหล่านั้นและเข้าใจตรงกับเบราว์เซอร์เกี่ยวกับ scheme ที่ใช้

Traefik สามารถทำ proxy สำหรับ WebSockets ได้โดยไม่ต้องตั้งค่าเพิ่มเติม ซึ่งเป็นเหตุผลที่แนะนำให้ใช้ในกรณีนี้ สำหรับ nginx นั้น proxy จะต้องส่งต่อ header สำหรับการอัปเกรด ได้แก่ proxy_set_header Upgrade $http_upgrade และ proxy_set_header Connection "upgrade" มิฉะนั้นคุณจะพบปัญหาหน้าเว็บค้างเช่นเดิมจากสาเหตุอื่น คุณสามารถใส่ค่าเหล่านี้ไว้ในบล็อก location / ทั่วไปได้ หรือจะแยกบล็อกสำหรับ /socket.io ก็สามารถทำได้เช่นกันแต่ไม่จำเป็น

การย้ายบอร์ดไปยังชื่อโฮสต์ใหม่ในภายหลังหมายถึงคุณต้องเปลี่ยนสองสิ่งพร้อมกัน คือค่า BASE_URL และกฎ Host() ของ Traefik หากคุณเปลี่ยนอย่างใดอย่างหนึ่งแล้วลืมอีกอย่างหนึ่ง คุณจะกลับไปพบปัญหาหน้าเว็บค้างอีกครั้ง การให้บริการ Planka จาก subpath เช่น https://example.com/planka สามารถทำได้ตั้งแต่เวอร์ชัน 2.1.0 เป็นต้นไป ซึ่งปล่อยออกมาในเดือนมีนาคม 2026 สำหรับ tag ที่เก่ากว่านี้ ควรใช้ subdomain แยกต่างหากแทน

ตำแหน่งที่ Planka จัดเก็บไฟล์แนบและรูปโปรไฟล์

Planka 2 จัดเก็บทุกสิ่งที่ผู้ใช้อัปโหลดไว้ภายใต้ path เดียวภายในคอนเทนเนอร์ คือ /app/data โดยไฟล์แนบ รูปโปรไฟล์ผู้ใช้ และรูปพื้นหลังของบอร์ดทั้งหมดจะถูกเก็บไว้ที่นี่ ในเวอร์ชัน 1 จะใช้ไดเรกทอรีแยกกัน 3 แห่ง ดังนั้นหากคัดลอกไฟล์ Compose มาจากบทความเก่าจะทำให้เกิดการ mount path ที่ไม่มีอยู่จริง และทำให้การ mount ข้อมูลที่จำเป็นขาดหายไป

การ mount เพียงจุดเดียวนี้คือความแตกต่างระหว่างบอร์ดที่ยังคงอยู่หลังการอัปเกรดกับปัญหาที่ต้องตามแก้ไขในภายหลัง อิมเมจ Docker ได้ประกาศให้ /app/data เป็น volume ดังนั้นหากละเว้นการ mount ในไฟล์ Compose ข้อมูลที่อัปโหลดจะไปอยู่ใน anonymous volume แม้ว่า Compose จะรักษาข้อมูลไว้ในระหว่างการทำ up ใหม่ตามปกติ แต่การทำ down ตามด้วย up ในภายหลังจะไม่เชื่อมต่อข้อมูลกลับมาโดยอัตโนมัติ บอร์ดจะกลับมาดูเหมือนปกติ การ์ดทั้งหมดจะยังอยู่ แต่ลิงก์ไฟล์แนบทุกรายการจะใช้งานไม่ได้ เนื่องจากแถวในฐานข้อมูลยังคงชี้ไปยังไฟล์ที่อยู่ใน volume เก่า

การใช้ named volume ในไฟล์ Compose ด้านบนจะช่วยป้องกันปัญหานี้ได้ การทำ bind mount ก็สามารถใช้งานได้เช่นกันและทำให้สำรองข้อมูลไฟล์ได้ง่ายขึ้นด้วยเครื่องมือทั่วไป แต่จำเป็นต้องมีขั้นตอนเพิ่มเติมอีกหนึ่งขั้นตอน เนื่องจากกระบวนการ Node ภายในคอนเทนเนอร์ทำงานด้วย UID 1000 ดังนั้นไดเรกทอรีบนโฮสต์ที่เป็นของ root จะทำให้เกิดข้อผิดพลาดเรื่องสิทธิ์การเข้าถึงเมื่อมีการอัปโหลดครั้งแรก:

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

ข้อดีและข้อเสียของการเลือกใช้งานทั้งสองแบบได้อธิบายไว้ใน bind mounts เทียบกับ named volumes

หากไฟล์แนบมีขนาดใหญ่เกินกว่าพื้นที่ดิสก์ในแผนของคุณ Planka สามารถเขียนไฟล์เหล่านั้นไปยังที่จัดเก็บที่รองรับ S3 ได้ผ่านทาง S3_ENDPOINT, S3_BUCKET และตัวแปร key ที่เกี่ยวข้อง ซึ่งสามารถชี้ไปยัง bucket ที่โฮสต์ไว้หรือ MinIO object store ที่คุณโฮสต์เอง บนเครื่องอื่น ควรตัดสินใจเรื่องนี้ก่อนที่ทีมงานจะเริ่มใช้งานบอร์ด เนื่องจากเมื่อเปิดใช้งาน S3 แล้ว ระบบจะเปลี่ยนไปอ่านและเขียนไฟล์ที่ backend นั้นทันทีโดยไม่มีการย้ายไฟล์ที่อัปโหลดไว้เดิมไปให้

เริ่ม stack และตรวจสอบว่าทำงานได้

docker compose pull
docker compose up -d
docker compose ps

docker compose ps ควรแสดง postgres เป็น healthy และ planka เป็น running หาก Planka restart วนซ้ำ ให้ตรวจสอบการเชื่อมต่อฐานข้อมูลเป็นลำดับแรก ไม่ใช่ตัวแอป

docker compose logs -f planka

การ boot ครั้งแรกที่ทำงานปกติจะรัน database migration แต่ production configuration จะกำหนด noShip: true และปิดข้อความตอนเริ่มต้นที่รายงานพอร์ต 1337 ตรวจสอบว่า schema ถูกสร้างจริงโดยสอบถาม Postgres โดยตรง แทนการเชื่อจาก log:

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

รายการ table ที่มี board และ card หมายความว่า migration ทำงานแล้ว ข้อความ "Did not find any relations" หมายความว่า Planka ไม่เคยเชื่อมต่อสำเร็จ ดังนั้นให้เปรียบเทียบ DATABASE_URL กับค่า POSTGRES_USER และ POSTGRES_PASSWORD ใน .env ของคุณ

จากนั้นตรวจสอบ route จากเครื่องของคุณเอง ไม่ใช่จาก VPS:

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

HTTP/2 200 หมายความว่า Traefik มี certificate และเข้าถึง container ได้ 404 ที่ Traefik ส่งกลับหมายความว่าไม่มี router ใดตรงกับ request: rule Host() ไม่ตรงกับ hostname ที่คุณเรียก หรือ Traefik ไม่เคยอ่าน labels เหล่านั้น 502 หมายความว่า router ตรงกับ request แต่ Traefik ไม่สามารถเข้าถึง container ได้ เช่น container ไม่ได้เชื่อมต่อกับ network proxy ตอนนี้ให้เปิดเว็บไซต์และเข้าสู่ระบบด้วย admin account

สำรองข้อมูลด้วย pg_dump ก่อนการอัปเกรดเวอร์ชันทุกครั้ง

ข้อมูลของบอร์ดจะถูกจัดเก็บไว้ในสองส่วนแยกกัน ดังนั้นการสำรองข้อมูลจึงต้องครอบคลุมทั้งฐานข้อมูล Postgres และ volume ของ planka-data ให้ทำการ dump ฐานข้อมูลในขณะที่ stack กำลังทำงานอยู่

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

คำสั่ง -T จะปิดการทำงาน pseudo-terminal ของ Compose เพื่อให้การ dump ข้อมูลส่งออกผ่าน stream ปกติ

จากนั้นให้สำรองข้อมูลส่วนอัปโหลด โดยต้องค้นหาชื่อ volume ที่แท้จริงก่อน เนื่องจาก Compose จะใส่ชื่อไดเรกทอรีโปรเจกต์นำหน้าชื่อ volume เสมอ

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 .

โปรเจกต์นี้ยังมี docker-backup.sh และ docker-restore.sh มาให้ใน repository และเอกสารอย่างเป็นทางการแนะนำให้ตั้งค่าเป็น cron job รายวัน ซึ่งทั้งสองวิธีนี้สามารถใช้งานได้ดี สิ่งที่ไม่ควรทำคือการมีข้อมูลสำรองที่คุณไม่เคยทดสอบกู้คืนมาก่อน ดังนั้นควรลองกู้คืนข้อมูลลงใน VPS สำรองสักครั้งเพื่อยืนยันว่าคุณสามารถล็อกอินและเปิดไฟล์แนบได้จริง รูปแบบการจัดเก็บข้อมูลแบบเดียวกันนี้จะพบได้ในแอปพลิเคชันที่ใช้ Compose ทุกตัวที่รองรับการอัปโหลดไฟล์ ดังนั้นหากในอนาคตคุณติดตั้ง Chatwoot บนเซิร์ฟเวอร์เดียวกับระบบ support desk ขั้นตอนที่คุณสร้างขึ้นในที่นี้จะสามารถนำไปปรับใช้ต่อได้โดยเพียงแค่เปลี่ยนชื่อ volume เท่านั้น

ให้ทำการ dump ข้อมูลทันทีก่อนการเปลี่ยนเวอร์ชันทุกครั้ง ข้อมูลสำรองจากเมื่อคืนไม่สามารถทดแทนข้อมูลสำรองที่ทำขึ้นก่อนการย้ายระบบ (migration) ที่คุณกำลังจะดำเนินการได้

กำหนด tag แบบตายตัวและอ่าน release notes

image tag ทั้ง 2 รายการในไฟล์นั้นถูกกำหนดแบบตายตัวโดยเจตนา

ghcr.io/plankanban/planka:2.2.1 เป็น release เฉพาะรุ่น ซึ่งเป็นรุ่นปัจจุบัน ณ October 2026 โดย Community 2.3.0 เปิดตัวเมื่อ November 4, 2026 พร้อม security fixes และ upstream แนะนำให้อัปเดต Community 2.3.1 ตามมาเมื่อ November 5, 2026 โดยแก้ crash ที่เกิดขณะแก้ไขคำอธิบาย card บน board ที่มีสมาชิกซึ่งไม่มี username latest จะเปลี่ยนไปทุกครั้งที่ upstream publish ดังนั้น docker compose pull ตามปกติอาจนำ schema migration เข้ามาในเวลาที่คุณไม่ได้เลือก อ่าน release notes ก่อนเปลี่ยนตัวเลขนั้น เพราะ breaking changes และ security fixes จะอธิบายไว้ที่นั่น Version 2.0.3 ถูกเผยแพร่เป็น security release ซึ่งเป็นสิ่งที่ควรอ่านก่อน แทนที่จะรับการเปลี่ยนแปลงโดยไม่ตั้งใจ เช่นเดียวกับ 2.2.1 ที่เผยแพร่ใน August 2026 โดยแก้ path traversal flaw ที่ทำให้ผู้ใช้ซึ่งเข้าสู่ระบบแล้วอ่านไฟล์ใด ๆ ได้บน instance ที่ใช้ local file storage ซึ่งเป็นการตั้งค่าในคู่มือนี้ และ advisory ระบุว่า 2.1.1 และรุ่นก่อนหน้าได้รับผลกระทบ หากคุณอัปเกรดมาจาก 2.1.x ให้อ่าน notes ของ 2.2.0 ก่อน เพราะ release นี้จะ deactivates ผู้ใช้ที่เคย sign in ผ่าน SSO เท่านั้น จนกว่า admin จะกำหนด password และเปิดใช้งานผู้ใช้เหล่านั้นอีกครั้ง การกำหนด tag แบบตายตัวทำได้ง่ายในกรณีนี้ เพราะ upstream publish images และหาก project ใดไม่มี image ให้ใช้งาน คุณยังต้องใช้แนวทางที่เข้มงวดแบบเดียวกัน แต่เพิ่มขั้นตอนอีกหนึ่งขั้น เช่น openGym ที่ build บนเครื่องจาก git tag ที่ checkout ไว้

postgres:16-alpine ถูกกำหนดไว้ที่ major version ด้วยเหตุผลที่สำคัญกว่า Postgres จะเขียน data directory ใน format ที่ผูกกับ major version และ server จะปฏิเสธการเปิด directory ที่เขียนโดย major version อื่น หากเขียน postgres:latest แล้วปล่อยให้ tag เลย 16 ไป container จะไม่เริ่มทำงาน ตัวอย่างเช่น image รุ่น 17 จะหยุดพร้อมข้อความ:

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 จากรุ่นเก่าแล้ว restore ลงใน data directory ใหม่บนรุ่นใหม่ ใช้การรัน pg_upgrade ซึ่งจะแปลงข้อมูลโดยไม่ต้อง dump แต่ต้องมี binary ของ server รุ่นเก่าและรุ่นใหม่พร้อมกัน หรือใช้ logical replication ไปยัง server ที่ใช้รุ่นใหม่ แล้วจึงทำ switchover แต่ละวิธีเป็น migration ที่ต้องวางแผน ไม่ใช่ผลข้างเคียงจากการ pull image; logical replication ทำให้ server เดิมทำงานต่อได้ขณะที่ server ใหม่ตามข้อมูลให้ทัน

หากคุณกำลังย้าย Planka 1.x ที่มีอยู่ แทนการเริ่มต้นใหม่ การอัปเกรดนั้นมีขั้นตอนที่จัดทำไว้ใน เอกสารของ project และไม่สามารถย้อนกลับไป version 1 ได้หากไม่ได้ทำ backup ไว้ล่วงหน้า

รูปแบบความล้มเหลวและข้อความที่คุณจะพบ

Planka รีสตาร์ทวนลูปและ log ระบุถึงฐานข้อมูล ข้อมูลรับรองใน DATABASE_URL ไม่ตรงกับสภาพแวดล้อมของ Postgres โปรดทราบว่า POSTGRES_PASSWORD จะถูกนำไปใช้เฉพาะเมื่อมีการเริ่มต้นไดเรกทอรีข้อมูลเป็นครั้งแรกเท่านั้น ดังนั้นการแก้ไขตัวแปรหลังจากบูตครั้งแรกที่ล้มเหลวจะไม่ส่งผลใดๆ ให้เปลี่ยนรหัสผ่านของ role ในฐานข้อมูลด้วย ALTER ROLE ให้ตรงกับรหัสผ่านที่ตั้งค่าไว้ การลบ volume db-data เป็นทางเลือกสำหรับกรณีการติดตั้งแบบชั่วคราวที่ไม่มีข้อมูลสำคัญต้องเก็บรักษาเท่านั้น

เข้าสู่ระบบสำเร็จแต่บอร์ดไม่โหลด BASE_URL ไม่ตรงกับที่อยู่ในแถบที่อยู่ของเบราว์เซอร์ เซิร์ฟเวอร์จึงปฏิเสธ origin ของ socket คอนโซลของเบราว์เซอร์จะแสดงคำขอที่ล้มเหลวไปยัง /socket.io/

การอัปโหลดล้มเหลวในขณะที่ส่วนอื่นทำงานปกติ เกิดจาก bind mount ที่มี root เป็นเจ้าของ ให้รัน sudo chown -R 1000:1000 บนไดเรกทอรีของโฮสต์แล้วรีสตาร์ทคอนเทนเนอร์

ไฟล์แนบหายไปหลังจากการอัปเกรด /app/data ไม่ได้ถูกเชื่อมต่อกับ volume ของไฟล์อัปโหลดเดิม ให้เชื่อมต่อ volume นั้นกลับเข้าไปหรือกู้คืนไฟล์จากข้อมูลสำรอง จากนั้นใช้ named volume ก่อนที่คุณจะเปลี่ยน image tag อีกครั้ง

Traefik ส่งคืนค่า 404 ไม่มี router ใดตรงกับคำขอ: กฎ Host() ไม่ตรงกับระเบียน DNS ของคุณ หรือ label ไม่ถูกส่งไปยัง Traefik คำสั่ง docker compose config จะแสดง label หลังจากแทนที่ค่าแล้ว ซึ่งเป็นจุดที่สามารถตรวจพบคำผิดได้ หากเป็น 502 หมายความว่าเส้นทางตรงกันแต่ไม่สามารถเข้าถึงคอนเทนเนอร์ได้ ให้ตรวจสอบว่าคอนเทนเนอร์อยู่ในเครือข่าย proxy หรือไม่

การแจ้งเตือนหรือ webhooks ไม่ทำงาน Planka 2 ส่งคำขอ HTTP ขาออกผ่านตัวกรองภายใน และรายการบล็อกเริ่มต้นครอบคลุม localhost และ postgres เว็บฮุคที่ชี้ไปยัง localhost จะถูกบล็อกโดยการออกแบบ และเมื่อคุณตั้งค่า OUTGOING_ALLOWED_HOSTS แล้ว โฮสต์ทุกตัวที่ไม่อยู่ในรายการนั้นจะถูกบล็อกเช่นกัน ให้ชี้เว็บฮุคไปยังชื่อบริการของคอนเทนเนอร์อื่น และเพิ่มชื่อนั้นลงใน OUTGOING_ALLOWED_HOSTS หากคุณใช้รายการอนุญาต (allow list) แทนที่จะลบตัวกรองออก

เมื่อระบบทำงานแล้ว ภาระในการดูแลรักษาจะต่ำ ให้ติดตามบันทึกการปล่อยซอฟต์แวร์ (release notes) และสำรองข้อมูลฐานข้อมูลก่อนการอัปเกรดทุกครั้ง การรีบูตจะทำให้ stack กลับมาทำงานได้เองเนื่องจาก restart: unless-stopped ตราบใดที่บริการ Docker ถูกเปิดใช้งานตอนบูต และ Compose stacks ที่กลับมาทำงานหลังรีบูต จะครอบคลุมกรณีที่ระบบไม่กลับมาทำงานตามปกติ

FAQ

ทำไม Planka ถึงโหลดค้างหลังจากที่ฉันเข้าสู่ระบบ?

ข้อมูลประจำตัวได้รับการยอมรับแต่การเชื่อมต่อแบบ live กลับไม่สำเร็จ เบราว์เซอร์จะเปิด socket ไปยัง origin ของหน้าเว็บ ในขณะที่ Planka จะกำหนด origin ของ socket ที่อนุญาตจาก BASE_URL ดังนั้นการปล่อยให้ตัวแปรดังกล่าวเป็น http://localhost:3000 ในขณะที่คุณเข้าถึงไซต์ผ่าน https://kanban.example.com จะทำให้เซิร์ฟเวอร์ปฏิเสธการเชื่อมต่อ ในคอนโซลสำหรับนักพัฒนาจะแสดงคำขอที่ล้มเหลวไปยัง /socket.io/ ให้ตั้งค่า BASE_URL เป็นที่อยู่สาธารณะที่ถูกต้องโดยไม่มีเครื่องหมายทับปิดท้าย เพิ่ม TRUST_PROXY=true เพื่อให้แอปยอมรับ header X-Forwarded-Proto จาก reverse proxy ของคุณ จากนั้นรัน docker compose up -d

ฉันจะสร้างผู้ดูแลระบบคนแรกของ Planka ได้อย่างไร?

ตั้งแต่เวอร์ชัน 1.13 เป็นต้นมา จะไม่มีการสร้างผู้ดูแลระบบโดยอัตโนมัติ คุณสามารถเลือกตั้งค่า DEFAULT_ADMIN_EMAIL พร้อมกับตัวแปรรหัสผ่าน ชื่อ และชื่อผู้ใช้ที่ตรงกันแล้วเริ่ม stack หรือรัน docker compose run --rm planka npm run db:create-admin-user แล้วตอบคำถามตาม prompt คำสั่งแบบโต้ตอบมีความปลอดภัยมากกว่าบนเซิร์ฟเวอร์ที่ใช้งานร่วมกัน เนื่องจากรหัสผ่านจะไม่ถูกส่งเข้าไปใน environment ที่กำหนดค่าไว้ของคอนเทนเนอร์ซึ่ง docker inspect สามารถอ่านได้ การคงค่า DEFAULT_ADMIN_EMAIL ไว้หลังจากนั้นจะป้องกันการเปลี่ยนแปลงชื่อ บทบาท และที่อยู่อีเมลของบัญชีนั้น และป้องกันการลบบัญชีออกจากอินเทอร์เฟซ ให้ลบ DEFAULT_ADMIN_PASSWORD ออกหลังจากตั้งค่าเสร็จสิ้น เพราะการปล่อยให้ค่านี้คงอยู่จะทำให้รหัสผ่านของบัญชีที่เกี่ยวข้องถูกรีเซ็ตทุกครั้งที่เริ่มระบบ

Planka จัดเก็บไฟล์แนบและรูปโปรไฟล์ไว้ที่ไหน?

ไฟล์ที่อัปโหลดทั้งหมดจะอยู่ใน /app/data ภายในคอนเทนเนอร์ใน Planka 2 รวมถึงไฟล์แนบ รูปโปรไฟล์ผู้ใช้ และภาพพื้นหลังของบอร์ด ให้ mount path ดังกล่าวเข้ากับ named volume หากไม่มีการ mount ที่ชัดเจน Docker image จะใช้ anonymous volume ซึ่งคำสั่ง docker compose up ในภายหลังจะไม่เชื่อมต่อกลับโดยอัตโนมัติหลังจาก docker compose down การทำ bind mount ก็สามารถทำได้เช่นกัน แต่กระบวนการ Node จะรันด้วย UID 1000 ดังนั้นให้รัน sudo chown -R 1000:1000 บนไดเรกทอรีของโฮสต์ มิฉะนั้นการอัปโหลดจะล้มเหลวด้วยข้อผิดพลาดด้านสิทธิ์การเข้าถึง

การ self-host Planka ต้องใช้ RAM เท่าไหร่?

FAQ ทางเทคนิคของโปรเจกต์แนะนำให้ใช้ RAM อย่างน้อย 2 GB และพื้นที่จัดเก็บข้อมูล 10 GB สำหรับทีมขนาดเล็ก การติดตั้งใช้งาน Docker แบบมาตรฐานจะรันกระบวนการ Node, เซิร์ฟเวอร์ Postgres พร้อมกระบวนการ backend ต่อการเชื่อมต่อที่เปิดอยู่หนึ่งรายการ และ proxy ภายในสำหรับกรองคำขาออก ให้รัน docker stats --no-stream หลังจากใช้งานผ่านไปหนึ่งสัปดาห์ตามปกติแล้วจึงประเมินขนาดจากตัวเลขของคุณเอง ให้เฝ้าระวังพื้นที่ดิสก์มากกว่าหน่วยความจำ เนื่องจากไฟล์แนบคือส่วนที่จะเพิ่มขนาดขึ้นเรื่อยๆ

ฉันจะอัปเกรด Planka โดยไม่ให้ข้อมูลสูญหายได้อย่างไร?

ให้สำรองข้อมูลฐานข้อมูลและจัดเก็บไฟล์ใน volume ที่อัปโหลดทันทีก่อนทำการอัปเกรด ไม่ใช่ใช้ข้อมูลจากตารางเวลาของเมื่อคืน ให้ใช้ docker compose exec -T postgres pg_dump -U planka -d planka > planka-db.sql โดยคงค่า -T ไว้เพื่อปิดการจัดสรร pseudo-terminal สำหรับผลลัพธ์ที่ถูกเปลี่ยนเส้นทาง อ่านบันทึกประจำรุ่น (release notes) สำหรับทุกเวอร์ชันที่คุณข้ามไป เปลี่ยน image tag ให้เป็นรุ่นที่ระบุแทนที่จะเป็น latest จากนั้นรัน docker compose pull และ docker compose up -d พร้อมทั้งตรวจสอบ log สำหรับการย้ายข้อมูล (migration) ให้คงค่า Postgres tag ไว้ที่เวอร์ชันหลัก (major version) เดิม เนื่องจากเซิร์ฟเวอร์จะปฏิเสธการเปิดไดเรกทอรีข้อมูลที่ถูกเขียนโดยเวอร์ชันหลักที่แตกต่างกัน

บทความนี้มีประโยชน์หรือไม่