Kanboard는 자체 서버에서 호스팅할 수 있는 경량 칸반 프로젝트 추적기입니다. 다른 칸반 추적기와 달리 어디에서나 액세스할 수 있는 간단하고 직관적인 인터페이스를 만드는 것을 목표로 합니다.
이 기사에서는 Ubuntu 22.04에 Kanboard를 설치하는 방법을 보여줍니다. 또한 커뮤니티 플러그인을 사용하여 Kanboard를 확장하는 프로세스를 강조합니다.
왜 칸보드를 사용하나요?
Kanboard의 가장 큰 장점 중 하나는 Docker의 마법을 통해 거의 모든 서버에서 작동할 수 있다는 것입니다. 결과적으로 Kanboard 호스팅은 기술적인 지식이 없는 사용자에게도 쉽고 간편합니다.
그 외에도 Kanboard에는 유연한 플러그인 플랫폼도 함께 제공됩니다. 여기에는 태그 생성, 시간 추적, 사용자 정의 스크립트 실행 기능이 포함됩니다. 예를 들어, 콘텐츠에 따라 각 카드의 속성을 업데이트하는 플러그인을 만들 수 있습니다.

팁: 아이젠하워 매트릭스를 이해하여 효율적이고 효과적으로 작업 우선순위를 지정하는 방법을 알아보세요.
칸보드 설치
- Kanboard 설치의 첫 번째 단계는 시스템이 최신 상태인지 확인하는 것입니다. 다음 명령을 실행하여 이 작업을 수행할 수 있습니다.
sudo apt update sudo apt upgrade
- Docker 프로젝트의 타사 저장소 키를 설치합니다.
sudo install -m 0755 -d /etc/apt/keyrings curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/docker.gpg sudo chmod a+r /etc/apt/trusted.gpg.d/docker.gpg
- 선호하는 텍스트 편집기를 사용하여 새로운 적절한 저장소 파일을 만듭니다.
sudo nano /etc/apt/sources.list.d/docker.list
- 공식 Docker 저장소에 대한 저장소 정보를 작성합니다.
deb [arch=amd64 signed-by=/etc/apt/trusted.gpg.d/docker.gpg] https://download.docker.com/linux/ubuntu jammy stable
- 다음을 눌러 새 저장소 파일을 저장하세요. Ctrl 키 + 영형그 다음에 Ctrl 키 + 엑스.
- 다음 명령을 실행하여 시스템의 저장소 세부 정보를 업데이트하십시오.
sudo apt update
- apt를 사용하여 종속성과 함께 Docker 엔진을 설치합니다.
sudo apt install wget docker-ce docker-ce-cli containerd.io docker-compose-plugin docker-buildx-plugin
칸보드 얻기
Docker 엔진이 제대로 설치되면 다음으로 할 일은 Kanboard용 Docker Compose 스크립트를 가져오는 것입니다. 이는 Docker에게 Kanboard를 자동으로 생성하는 방법을 알려주는 옵션 목록이 포함된 작은 텍스트 파일입니다.
- Kanboard용 홈 디렉터리에 별도의 폴더를 만듭니다.
mkdir ~/kanboard cd ~/kanboard
- 즐겨 사용하는 텍스트 편집기를 통해 “docker-compose.yml”이라는 이름의 새 텍스트 파일을 만듭니다.
nano ~/kanboard/docker-compose.yml
- 다음 코드 블록을 복사하여 “docker-compose.yml” 파일에 붙여넣습니다.
version: '2' services: kanboard: image: kanboard/kanboard:latest ports: - 8080:80 volumes: - kanboard_data:/var/www/app/data - kanboard_plugins:/var/www/app/plugins environment: DATABASE_URL: mysql://kanboard:!#REPLACE-ME@db/kanboard PLUGIN_INSTALLER: true db: image: mariadb:latest command: --default-authentication-plugin=mysql_native_password environment: MYSQL_ROOT_PASSWORD: !#REPLACE-ME MYSQL_DATABASE: kanboard MYSQL_USER: kanboard MYSQL_PASSWORD: !#REPLACE-ME volumes: - db:/var/lib/mysql volumes: kanboard_data: kanboard_plugins: db:
- 새 터미널을 열고 다음 명령을 사용하여 보안 비밀번호를 생성하십시오.
cat /dev/urandom | tr -dc 'A-Za-z0-9' | fold -w 16 | head -n 1
- 이전 터미널로 돌아가서 파일 내 “#!REPLACE-ME”의 모든 인스턴스에 보안 비밀번호를 붙여넣으세요.

- 다음을 눌러 “docker-compose.yml” 파일을 저장하고 종료합니다. Ctrl 키 + 영형그 다음에 Ctrl 키 + 엑스.
- 이제 다음 명령을 실행하여 Kanboard Docker 컨테이너를 빌드할 수 있습니다.
docker compose up -d

알아 둘만 한: 지금 Obsidian.md를 사용하여 오프라인 Kanban 보드를 만드는 방법을 알아보세요.
SSL용 Kanboard 설정
이제 부분적으로 작동하는 Kanboard 설치가 완료되었습니다. 하지만 안전하게 액세스하려면 먼저 Nginx 역방향 프록시를 만들어야 합니다. 이는 로드 밸런싱 및 SSL을 제공하는 웹 연결 서버 역할을 합니다.
- Nginx 웹서버를 설치합니다:
sudo apt install nginx
- Nginx 역방향 프록시에 대한 사이트 구성 파일을 만듭니다.
sudo nano /etc/nginx/sites-available/kanboard
- 새 사이트 구성 파일에 다음 코드 블록을 복사하여 붙여넣습니다.
server { listen 80; listen [::]:80; root /var/www/html; server_name my-kanban-domain-url.com; location / { proxy_set_header X-Forwarded-For $remote_addr; proxy_set_header Host $http_host; proxy_pass http://localhost:8080; } }
메모: “my-kanban-domain-url.com”을 실제 도메인 이름으로 바꿉니다.
- Kanboard 역방향 프록시에 대한 심볼릭 링크를 만듭니다.
sudo ln -s /etc/nginx/sites-available/kanboard /etc/nginx/sites-enabled/kanboard
- Nginx 서비스 데몬을 다시 로드합니다.
sudo systemctl reload nginx.service
Kanboard용 SSL 인증서 받기
역방향 프록시를 사용하면 이제 Kanboard에 대한 SSL 인증서를 요청할 수 있습니다. 이 섹션에서는 EFF(Electronic Frontier Foundation)의 Certbot을 통해 무료 인증서를 얻는 방법을 보여줍니다.
- 시작하려면 시스템의 핵심 스냅 데몬을 설치하고 업데이트해야 합니다.
sudo snap install core sudo snap refresh core
- certbot 스냅 패키지를 설치합니다:
sudo snap install --classic certbot
- certbot snap 바이너리와 시스템의 기본 바이너리 디렉토리 사이에 심볼릭 링크를 만듭니다:
sudo ln -s /snap/bin/certbot /usr/bin/certbot
- certbot을 사용하여 EFF에 등록하여 실행 중인지 테스트합니다.
sudo certbot register --agree-tos --email ramces@email.invalid
- 다음 명령을 실행하여 도메인 이름에 대한 SSL 인증서를 생성합니다.
sudo certbot
항목에서 도메인을 선택하면 도메인에 대한 SSL을 생성하는 작업이 수행됩니다.
알아 둘만 한: 자체 서명된 SSL 인증서를 생성하여 인터넷을 통한 암호화에 대해 자세히 알아보세요.
로그인 및 칸반 보드 생성
이제 Kanban 보드를 생성하고 관리하기 위해 Kanboard를 사용할 수 있습니다. 그렇게 하려면 웹 브라우저에서 도메인 이름에 액세스하여 Kanboard 인스턴스에 로그인하세요.
- 로그인 화면에서 사용자 이름과 비밀번호로 “admin”을 사용하십시오.
- 공개 칸반 보드를 생성하려면 “새 프로젝트”를 클릭하세요.

- 새 보드의 이름과 URL 슬러그를 제공하세요.
- 페이지 왼쪽 사이드바에서 “공개 액세스”를 클릭하세요.

- 파란색 “공개 액세스 활성화” 버튼을 클릭하세요. 이렇게 하면 RSS 피드와 Kanboard 사용자가 아닌 사용자와 공유할 수 있는 공개적으로 볼 수 있는 링크가 생성됩니다.

- 페이지 왼쪽 상단에 있는 “보드” 버튼을 클릭하면 보드에 새 항목에 액세스하고 만들 수 있습니다.

협업 칸반 보드용 사용자 생성
공개적으로 액세스할 수 있는 “보기 전용” 보드를 공유하는 것 외에도 Kanboard를 사용하여 여러 로컬 사용자 간의 공동 “작업” 보드를 만들 수도 있습니다.
- 페이지 오른쪽 상단에 있는 관리자 아이콘을 클릭한 다음 ‘사용자 관리’를 선택하세요.

- 페이지의 왼쪽 상단 사이드바에 있는 “새 사용자” 링크를 클릭하세요.
- 그러면 Kanboard가 새 사용자의 사용자 이름과 비밀번호를 묻는 작은 대화 상자가 나타납니다.

- 프롬프트 하단까지 아래로 스크롤하고 “프로젝트” 카테고리 아래의 드롭다운 상자를 클릭합니다.

- 사용자가 속할 Kanban 보드를 선택합니다.

- 새로운 사용자 계정을 생성하려면 “저장”을 클릭하세요.

플러그인을 사용하여 칸반 보드 사용자 정의
Kanboard의 뛰어난 기능 중 하나는 기본 기능 이상으로 보드를 확장할 수 있는 프레임워크를 제공한다는 것입니다. 이는 서버에 대한 사용자 정의 기능을 포함하기 위해 개발자에게 의존할 필요가 없음을 의미합니다.
- 새 플러그인을 추가하려면 페이지 오른쪽 상단에 있는 관리자 아이콘을 클릭한 다음 ‘플러그인’을 선택하세요.

- 페이지 왼쪽 사이드바에서 “플러그인 디렉터리” 카테고리를 클릭하세요.

- Kanboard 서버에 설치하려는 플러그인을 찾으세요. 제 경우에는 “MarkdownPlus”를 설치하여 서버의 기본 Markdown을 확장하겠습니다.

- “설치”를 클릭한 다음 웹페이지를 새로 고쳐 서버에 플러그인을 올바르게 로드하세요.

참고: 칸반은 작업과 데이터를 관리하는 유일한 방법은 아닙니다. 지금 Todoist를 사용하여 할 일 목록과 데이터를 최적화하는 방법을 알아보세요.
자주 묻는 질문
내 Kanban 보드의 내용을 백업할 수 있습니까?
예. 특정 Kanban 보드를 백업하려면 내보낼 보드에서 기어 아이콘을 클릭한 다음 “내보내기”를 클릭하세요.
그러면 Kanboard가 내보내려는 날짜 범위를 묻는 작은 프롬프트가 나타납니다. 시작일과 종료일을 입력한 후 ‘내보내기’를 클릭하세요.
내 칸반 보드의 “잠금” 기간을 재설정할 수 있습니까?
예. Kanboard에서는 특정 사용자의 잠긴 타이머를 재설정하는 것이 가능합니다. 이렇게 하려면 페이지 오른쪽 상단에 있는 관리자 아이콘을 클릭하세요. 그런 다음 “사용자 관리” 항목을 선택한 후 잠긴 사용자의 이름을 클릭하세요. 마지막으로 ‘보안’ 카테고리로 이동하여 ‘이 사용자 잠금 해제’를 클릭하세요.
Kanboard 컨테이너 내부의 config.php 파일을 수정할 수 있습니까?
예. 그러나 이렇게 하면 Docker 이미지의 일관성이 손상될 수 있습니다. 대신, 프로그램 개발자는 Kanboard 인스턴스의 값을 구성할 때 docker-compose.yml 파일 내의 환경 변수를 사용할 것을 제안합니다.
우리의 활동을 지원해주세요 ❤️
이 글이 마음에 드셨다면, 앞으로도 좋은 콘텐츠를 계속 발행할 수 있도록 팁을 남겨주세요.






















