install_desktop 설치 · 라이선스 비용 없음 & 오픈 소스

Klacks를 직접 운영하세요 — 귀사의 자체 인프라에서.

세 가지 방법, 하나의 결과: 사무실 PC용 Windows 패키지, 귀사 서버를 위한 가이드형 설치 프로그램 또는 자체 구성을 위한 Docker Compose 스택 — 등록도, 라이선스 비용도 필요 없습니다. 사무실 PC에서는 설치 중에 국가를 선택합니다. 서버와 Docker Compose의 경우 국가별 패키지에 귀사 국가의 공휴일, 근로시간 규정, 업종별 사전 설정이 처음부터 포함되어 있습니다(할증 수당은 국가별로 정의된 경우).

국가별 패키지

업종 선택 — 선택 사항

선택한 내용은 사전 설정으로 국가 프로필에 기록되며, 첫 시작 시 어떤 업종 블록이 활성화될지 결정합니다. 패키지에는 항상 모든 업종이 포함되어 있습니다 — 언제든지 앱에서 추가로 활성화할 수 있습니다.

computer

사무실 PC에서 (Docker 불필요)

사무실 PC가 한 대뿐인 사업장을 위한 방법: Windows용 설치 파일 — Docker도, 자체 서버도 필요 없습니다. 데이터베이스, Klacks, 업데이트 서비스는 Windows 백그라운드 서비스로 실행되고, 업데이트는 자동으로 적용되며, 데이터는 이 PC에 그대로 보관됩니다.

요구 사항
  • check_circle Windows 11(64비트)
  • check_circle Windows 10 22H2(64비트)에서도 실행됩니다. Microsoft는 Windows 10의 일반 지원을 종료했으며, 보안 업데이트는 유료 ESU 프로그램을 통해서만 제공됩니다.
  • check_circle Klacks는 이 PC에서 직접 사용합니다 — 네트워크의 다른 기기에서 접속하는 기능은 아직 지원되지 않습니다
  • check_circle 첫 시작 시(AI 모델, 약 700MB) 및 업데이트를 위한 인터넷 연결
  • check_circle 설치를 위한 관리자 권한
세 단계
  1. 1
    설치 파일 다운로드 “Windows용 다운로드”를 클릭합니다. 파일 “Klacks-Setup-win-x64.exe”는 보통 “다운로드” 폴더에 저장됩니다.
  2. 2
    두 번 클릭하고 국가 선택 파일을 두 번 클릭합니다. Windows SmartScreen 경고가 표시되면 추가 정보를 열고 그래도 실행하도록 선택합니다 — 이 설치 파일에는 아직 디지털 서명이 없습니다. 이어서 관리자 권한 요청을 승인합니다. 마법사에서 국가를 선택하고(공휴일, 시간대, 근로시간 규정) 원하면 바탕 화면 바로 가기도 만듭니다. 마법사에 진행 상황이 표시되며, 설치에는 몇 분이 걸립니다.
  3. 3
    Klacks 열기 및 로그인 마지막에 Klacks를 브라우저에서 여는 옵션을 선택합니다. 나중에는 시작 메뉴의 “Klacks”에서 열 수 있습니다(또는 http://localhost:5180). 마법사가 마지막에 보여 주는 초기 계정으로 로그인한 뒤 자체 관리자 계정을 만듭니다. Klacks가 아직 시작 중이면 몇 분 기다립니다 — 첫 시작은 조금 더 오래 걸립니다.
download Windows용 다운로드

64비트 Windows(x64)용입니다. ARM 프로세서를 탑재한 Windows 11 기기(예: Snapdragon X)에서는 Klacks가 에뮬레이션으로 실행되며, ARM 기반 Windows 10은 지원되지 않습니다.

Mac용: 곧 제공될 예정입니다.

Linux를 사용하시나요? 아래를 참조하세요: Linux PC에서 Klacks 사용하기.

제거: Klacks는 다른 Windows 프로그램처럼 제거할 수 있습니다 — 설정 › 앱을 열고 “Klacks” 항목을 찾아 제거합니다. 제거 프로그램은 데이터베이스, 설정, 백업도 삭제할지 묻습니다. “아니요”를 선택하면 데이터는 C:\ProgramData\Klacks에 남아 있어 나중에 다시 설치할 때 이어서 사용됩니다.

dns

가이드형 설치 프로그램

자체 서버를 위한 가이드형 방법: 설치 스크립트가 시크릿과 자체 서명 인증서를 생성하고, 최신 릴리스 버전을 가져와 전체 스택을 시작합니다 — Linux와 Windows 모두에서.

요구 사항
  • check_circle Docker Desktop(Windows) 또는 Compose 플러그인이 포함된 Docker Engine(Linux)
  • check_circle ghcr.io 및 github.com으로의 아웃바운드 연결(이미지 및 업데이트)
  • check_circle 사용 가능한 포트 80 및 443(변경 가능)
세 단계
  1. 1
    다운로드 및 압축 해제 귀사 국가용 ZIP을 다운로드하여 대상 컴퓨터에서 압축을 해제합니다.
  2. 2
    설치 스크립트 실행 Linux에서는 함께 제공되는 셸 스크립트를, Windows에서는 PowerShell 스크립트를 실행합니다. 스크립트는 시크릿과 인증서를 생성하고 국가 프로필을 적용하며 스택이 정상 작동할 때까지 기다립니다.
  3. 3
    로그인 후 비밀번호 변경 브라우저에서 로그인하고 함께 제공되는 README에 적힌 초기 비밀번호를 즉시 변경합니다.
download 설치 패키지 다운로드

klacks-onprem-kr-all.zip

deployed_code

Docker Compose

컨테이너 스택을 직접 관리하는 팀을 위한 직접적인 방법: docker-compose.yml, nginx 구성, 초기화 스크립트, 국가 프로필, 그리고 모든 변수가 준비된 .env 템플릿 — 완전한 통제권은 귀사에 있습니다.

요구 사항
  • check_circle Compose 플러그인이 포함된 Docker Engine(또는 Docker Desktop)
  • check_circle ghcr.io 및 github.com으로의 아웃바운드 연결(이미지 및 업데이트)
  • check_circle Docker Compose 스택 운영 경험
세 단계
  1. 1
    다운로드 및 압축 해제 귀사 국가용 Compose ZIP을 다운로드하여 압축을 해제합니다 — 함께 제공되는 README가 모든 단계를 안내합니다.
  2. 2
    .env 설정 .env.example 템플릿을 .env로 복사하고 서버 이름과 비밀번호/시크릿을 설정합니다. 국가 프로필 경로는 이미 입력되어 있습니다.
  3. 3
    스택 시작 “docker compose up -d”를 실행하고 브라우저에서 로그인한 뒤 초기 비밀번호를 즉시 변경합니다.
download Compose 패키지 다운로드

klacks-compose-kr-all.zip

terminal

Linux PC에서

사전 지식 없이도 Linux PC에 설치할 수 있는 간단한 방법: 패키지를 다운로드하고 터미널에 명령을 한 번 입력하면 — 나머지는 설치 프로그램이 알아서 처리합니다. 이후 Klacks는 이 PC에서 Docker로 실행되고, 업데이트는 자동으로 적용되며, 데이터는 이 PC에 그대로 보관됩니다.

요구 사항
  • check_circle 데스크톱 환경이 있는 64비트 Linux: Ubuntu, Debian 또는 Fedora. 다른 배포판(예: Linux Mint)은 공식적으로 지원되지 않습니다 — 이 경우 먼저 Docker를 직접 설치해 주세요.
  • check_circle 브라우저와 데스크톱이 함께 실행되므로 16GB 메모리를 권장합니다. 약 8GB 미만이면 설치 프로그램이 중단됩니다.
  • check_circle 첫 시작 시 및 업데이트를 위한 인터넷 연결
  • check_circle 이 PC의 관리자 비밀번호(sudo 비밀번호)
download Linux용 다운로드

klacks-onprem-kr-all.zip

세 단계
  1. 1
    패키지 다운로드 후 고정 폴더에 압축 풀기 ZIP 파일을 다운로드한 뒤, 앞으로도 그대로 둘 폴더에 압축을 풉니다. 예: 홈 폴더 안의 “klacks” 폴더 — “다운로드” 폴더는 사용하지 마세요. 자동 업데이트는 이 폴더를 사용하므로, 폴더를 삭제하면 업데이트가 더 이상 작동하지 않습니다.
  2. 2
    터미널 열고 명령 입력 압축을 푼 설치 파일이 있는 폴더에서 마우스 오른쪽 버튼을 클릭하고 “터미널에서 열기”를 선택한 뒤, 아래 명령을 입력하고 비밀번호로 확인합니다(입력하는 동안 비밀번호는 화면에 표시되지 않습니다). Docker가 없으면 설치 프로그램이 Docker 설치를 제안합니다. “y”로 답하세요 — 몇 분 정도 걸립니다. 설치를 위해 터미널이 필요한 것은 이번 한 번뿐입니다. 나중에 설치 프로그램을 다시 실행할 때(예: 복구)에도 sudo를 포함한 이 명령을 그대로 사용합니다.sudo bash install-kr.sh
  3. 3
    브라우저에서 열고 로그인 브라우저에서 https://localhost를 엽니다. 브라우저가 인증서에 대해 경고합니다 — 경고를 확인하고 진행하세요(“고급”을 누른 다음 “localhost(으)로 이동” 또는 “위험을 감수하고 계속”). 폴더 안의 README에 적힌 초기 계정으로 로그인한 뒤 비밀번호를 즉시 변경합니다.
lock

인증서 경고 안내: Klacks는 설치 중에 자체 인증서를 만드는데, 브라우저는 이 인증서를 알지 못합니다 — 그래서 경고가 표시됩니다. 그래도 연결은 암호화됩니다.

description

프로필만 — 기존 설치용

이미 Klacks를 사용 중이신가요? 프로필(JSON)에는 공휴일, 근로시간 규정, 할증 수당(국가별로 정의된 경우), 업종 등 국가별 사전 설정이 담겨 있으며, 설치 후 첫 시작 시 적용됩니다. 나중에 다른 업종을 해당 사전 설정과 함께 추가할 때도 이 방법을 사용합니다.

description 프로필(JSON) 다운로드

알아두면 좋은 정보

code

오픈 소스(AGPL-3.0)

전체 소스 코드는 AGPL-3.0 라이선스로 GitHub에 공개되어 있습니다 — 라이선스 비용도, 벤더 종속도 없습니다.

storage

데이터는 귀사의 서버에 있습니다

Klacks는 귀사의 인프라에서 실행됩니다. 인사 및 근무 데이터는 귀사의 서버에 있습니다 — 강제되는 클라우드는 없습니다. 외부 AI 제공업체를 선택한 경우에만 요청이 해당 업체로 전송되며, 로컬 모델을 사용하면 외부 제공업체로 가는 AI 요청이 없습니다.

update

업데이트

업데이트 서비스가 새로 릴리스된 버전을 자동으로 적용합니다 — Docker에서는 스택 내 서비스로, 사무실 PC에서는 Windows 백그라운드 서비스로 실행됩니다.

lock

Docker 사용 시 HTTPS

설치 프로그램은 시작을 위해 자체 서명 인증서를 생성합니다 — 언제든지 자체 인증서로 교체할 수 있습니다. 첫 로그인 직후 초기 비밀번호를 즉시 변경하세요. 사무실 PC용 Windows 패키지는 인증서 없이 http://localhost:5180에서 실행됩니다.

먼저 체험해 보고 설치할까요?

Playground에서는 설치나 등록 없이 브라우저에서 바로 예시 데이터로 Klacks를 테스트할 수 있습니다 — 또는 GitHub에서 소스 코드를 살펴보세요.

code GitHub에서 보기
Reload X