바른 삭제하기

바른을 컴퓨터에서 지우는 방법을 설치 방식별로 설명합니다. 설치 방식은 네 가지입니다. 리눅스 패키지(.deb), 맥OS 인스톨러(.pkg), 윈도우 인스톨러(.msi), 그리고 압축 파일(tar.gz·zip)을 직접 푼 경우입니다.

어느 방식이든 순서는 같습니다.

(선택) 이 컴퓨터에 등록한 API 키를 해제합니다.
서비스를 멈춥니다.
프로그램을 제거합니다.
남은 데이터 폴더를 지웁니다.
제거가 끝났는지 확인합니다.

설치 방식별 위치 한눈에 보기

설치 방식	설치 위치	서비스 이름	제거 뒤에도 남는 데이터 폴더
리눅스(.deb)	`/opt/bareun`	systemd 서비스 `bareun`	`/opt/bareun/var`
맥OS(.pkg)	`/Applications/bareun.app`	LaunchDaemon `ai.baikal.bareun`	`/Library/Application Support/bareun/var`
윈도우(.msi)	`C:\Program Files\bareun` (설치할 때 고른 폴더)	윈도우 서비스 `bareunsvc` (표시 이름 `바른 한국어 형태소분석기`)	`C:\Program Files\bareun\var`
압축 파일(tar.gz·zip)	압축을 푼 폴더	없음 (직접 실행)	압축을 푼 폴더 전체

패키지를 제거해도 데이터 폴더는 남습니다

var 폴더에는 바른이 실행되면서 만든 파일이 쌓입니다. 패키지 관리자와 인스톨러는 설치할 때 넣은 파일만 지우므로, 이 폴더는 제거한 뒤에도 그대로 남습니다.

models/: 서버를 처음 실행할 때 내려받은 모델과 사전
custom-dict/: 사용자 사전
logs/: 로그 파일
license.pem: 라이선스 파일
api-keys.db.pb: 이 컴퓨터에 등록한 API 키 정보

바른을 완전히 지우려면 아래 설치 방식별 설명에 따라 이 폴더까지 지우세요.

지우기 전에 백업할 것

다시 설치할 계획이라면 지우기 전에 다음을 챙겨 두세요.

사용자 사전: 단어 목록 원본을 보관해 두었다가, 새로 설치한 뒤 UpdateCustomDictionary API로 다시 등록하는 방법을 권장합니다. (사용자 사전을 Git으로 버전 관리하기 참고) 같은 컴퓨터에 다시 설치해 그대로 쓰려면 var/custom-dict 폴더를 복사해 둡니다.
라이선스 파일: var/license.pem을 복사해 둡니다.
API 키: 키 값을 따로 적어 두었다가, 다시 설치한 뒤 bareun -reg 명령이나 관리자용 웹에서 등록합니다.
모델은 백업하지 않아도 됩니다. 서버를 처음 실행할 때 버전에 맞는 모델을 자동으로 내려받습니다.

홈 폴더에 둔 설정 파일

설정 파일(bareun.json)을 홈 폴더의 .bareun 폴더에 따로 만들어 두었다면, 이 폴더는 어떤 방식으로 제거해도 남습니다. 필요 없으면 직접 지우세요.

설치 방식별 삭제 방법

.deb 패키지는 /opt/bareun에 설치되고, systemd 서비스 bareun으로 실행됩니다. 패키지 이름은 bareun입니다(GPU용 패키지도 이름이 같습니다).

1. API 키 등록 해제 (선택)

서비스가 실행 중일 때 다음 명령으로 이 컴퓨터의 API 키 등록을 해제할 수 있습니다.

sudo /opt/bareun/bin/bareun -unreg 발급받은-API-키

2. 서비스 멈추기

서비스를 멈추고, 부팅할 때 자동으로 시작하지 않도록 끕니다.

sudo systemctl disable --now bareun

3. 패키지 제거하기

sudo apt remove bareun
sudo systemctl daemon-reload

apt remove는 설치할 때 넣은 프로그램 파일(/opt/bareun 아래)과 서비스 파일 (/etc/systemd/system/bareun.service)을 지웁니다.

apt remove와 apt purge의 차이

apt purge bareun은 apt remove에 더해 패키지의 설정 파일까지 지웁니다. 그런데 바른 패키지는 따로 관리하는 설정 파일이 없어서, 두 명령의 결과가 같습니다. 두 명령 모두 서버가 실행하면서 만든 /opt/bareun/var 폴더는 지우지 않습니다. 제거하는 중에 directory '/opt/bareun/var' not empty so not removed 같은 안내가 나올 수 있는데, 이 폴더가 남는다는 안내이므로 오류가 아닙니다.

4. 남은 데이터 지우기

사용자 사전과 라이선스를 보존하려면 먼저 /opt/bareun/var/custom-dict 폴더와 /opt/bareun/var/license.pem을 다른 곳에 복사해 두세요. 그다음 남은 폴더를 지웁니다.

sudo rm -rf /opt/bareun

5. 제거 확인하기

systemctl status bareun      # "Unit bareun.service could not be found." 가 나오면 서비스가 없습니다.
dpkg -l | grep bareun        # 아무것도 나오지 않거나, 첫 칸이 ii 가 아니면 패키지가 제거된 상태입니다.
ss -ltn | grep 5656          # 아무것도 나오지 않으면 5656 포트를 쓰는 프로그램이 없습니다.
ls /opt/bareun               # "No such file or directory" 가 나오면 폴더까지 지워졌습니다.

.pkg 인스톨러는 프로그램을 /Applications/bareun.app에 설치하고, LaunchDaemon ai.baikal.bareun으로 등록해 부팅할 때마다 실행합니다. 데이터는 /Library/Application Support/bareun/var에 쌓입니다. 맥OS에는 인스톨러용 제거 프로그램이 따로 없으므로 아래 순서대로 직접 지웁니다.

1. API 키 등록 해제 (선택)

서비스가 실행 중일 때 다음 명령으로 이 컴퓨터의 API 키 등록을 해제할 수 있습니다.

sudo /Applications/bareun.app/Contents/MacOS/bareun -unreg 발급받은-API-키

2. 서비스 멈추기

sudo launchctl bootout system/ai.baikal.bareun

sudo bareunctl stop으로 멈춰도 같습니다. 서비스가 이미 멈춰 있으면 오류 안내가 나오는데, 그대로 다음 단계로 넘어가면 됩니다.

3. 프로그램과 서비스 파일 지우기

sudo rm -f /Library/LaunchDaemons/ai.baikal.bareun.plist
sudo rm -f /usr/local/bin/bareunctl
sudo rm -rf /Applications/bareun.app

/Library/LaunchDaemons/ai.baikal.bareun.plist: 부팅할 때 바른을 실행하는 서비스 등록 파일
/usr/local/bin/bareunctl: 서비스 제어 명령 bareunctl의 바로가기(심볼릭 링크)
/Applications/bareun.app: 프로그램 본체

4. 설치 기록 지우기

맥OS는 .pkg로 설치한 기록을 따로 보관합니다. 프로그램 파일을 지운 뒤 이 기록도 지웁니다.

sudo pkgutil --forget ai.baikal.bareun

5. 남은 데이터 지우기

사용자 사전과 라이선스를 보존하려면 먼저 /Library/Application Support/bareun/var/custom-dict 폴더와 /Library/Application Support/bareun/var/license.pem을 다른 곳에 복사해 두세요. 그다음 남은 폴더를 지웁니다.

sudo rm -rf "/Library/Application Support/bareun"

예전 버전을 설치했던 맥

예전 버전의 바른은 서비스 등록 파일 이름이 달랐습니다. 다음 파일이 남아 있으면 함께 지웁니다.

sudo launchctl bootout system /Library/LaunchDaemons/bareun.plist
sudo rm -f /Library/LaunchDaemons/bareun.plist /Library/LaunchAgents/bareun.plist

6. 제거 확인하기

pkgutil --pkgs | grep bareun                  # 아무것도 나오지 않으면 설치 기록이 지워졌습니다.
sudo launchctl print system/ai.baikal.bareun  # 서비스를 찾을 수 없다는 안내가 나오면 서비스가 없습니다.
lsof -nP -iTCP:5656 -sTCP:LISTEN              # 아무것도 나오지 않으면 5656 포트를 쓰는 프로그램이 없습니다.
ls /Applications/bareun.app                   # "No such file or directory" 가 나오면 프로그램이 지워졌습니다.

.msi 인스톨러는 바른을 C:\Program Files\bareun(설치할 때 다른 폴더를 골랐다면 그 폴더)에 설치하고, 윈도우 서비스 bareunsvc(표시 이름 바른 한국어 형태소분석기)로 등록합니다. 아래 명령은 모두 관리자 권한 명령 프롬프트에서 실행합니다 (명령 프롬프트 아이콘을 마우스 오른쪽 버튼으로 눌러 "관리자 권한으로 실행").

1. API 키 등록 해제 (선택)

서비스가 실행 중일 때 다음 명령으로 이 컴퓨터의 API 키 등록을 해제할 수 있습니다.

"C:\Program Files\bareun\bin\bareun.exe" -unreg 발급받은-API-키

2. 서비스 멈추기

sc stop bareunsvc

services.msc에서 바른 한국어 형태소분석기를 골라 중지해도 됩니다. 서비스가 실행 중인 채로 제거하면 제거가 끝난 뒤 재시작을 요구하므로, 먼저 멈추는 것이 좋습니다.

3. 프로그램 제거하기

다음 방법 가운데 하나를 고릅니다.

시작 메뉴의 바른 폴더에서 바른 제거를 누릅니다.
윈도우 설정에서 지웁니다. 윈도우 11은 설정 > 앱 > 설치된 앱, 윈도우 10은 설정 > 앱 > 앱 및 기능에서 바른을 찾아 제거를 누릅니다.
명령으로 지웁니다. 설치에 쓴 .msi 파일이 있으면 그 파일로 제거할 수 있습니다.
```
msiexec /x bareun-설치파일.msi
```
설치 파일이 없으면 PowerShell(관리자)에서 다음 명령으로 제거합니다.
```
Get-CimInstance Win32_Product -Filter "Name = '바른'" |
  ForEach-Object { Start-Process msiexec.exe -ArgumentList "/x $($_.IdentifyingNumber)" -Wait }
```

제거하면 다음이 함께 정리됩니다.

윈도우 서비스 bareunsvc (멈춘 뒤 등록 해제)
시스템 환경 변수 BAREUN_ROOT
시작 메뉴의 바른 폴더와 바탕 화면의 바른 바로가기
설치할 때 넣은 프로그램 파일

4. 남은 데이터 지우기

제거한 뒤에도 C:\Program Files\bareun\var 폴더가 남습니다. 사용자 사전과 라이선스를 보존하려면 먼저 var\custom-dict 폴더와 var\license.pem을 다른 곳에 복사해 두세요. 그다음 남은 폴더를 지웁니다.

rmdir /s /q "C:\Program Files\bareun"

5. 제거 확인하기

새 명령 프롬프트 창을 열고 다음을 실행합니다.

sc query bareunsvc
echo %BAREUN_ROOT%
netstat -ano | findstr :5656

sc query bareunsvc에서 1060 오류(지정된 서비스가 설치된 서비스로 존재하지 않음)가 나오면 서비스가 지워졌습니다.
echo %BAREUN_ROOT%가 %BAREUN_ROOT%를 그대로 출력하면 환경 변수가 지워졌습니다. 환경 변수는 새로 연 창에만 반영되므로, 제거하기 전에 열어 둔 창에서는 값이 남아 보일 수 있습니다.
netstat 결과가 비어 있으면 5656 포트를 쓰는 프로그램이 없습니다.

압축 파일로 설치했다면 바른은 압축을 푼 폴더 안에만 있습니다. 모델·사용자 사전·로그·라이선스·API 키 정보도 모두 그 폴더의 var 아래에 있으므로, 실행을 멈추고 폴더를 지운 뒤 설치할 때 등록한 환경 변수를 지우면 됩니다. 아래 예시의 경로는 설치 문서의 예시를 따른 것이므로, 실제로 압축을 푼 경로로 바꿔 입력하세요.

1. API 키 등록 해제 (선택)

서버가 실행 중일 때 다음 명령으로 이 컴퓨터의 API 키 등록을 해제할 수 있습니다.

# 리눅스·맥OS
$BAREUN_ROOT/bin/bareun -unreg 발급받은-API-키

rem 윈도우
c:\Users\me\bareun-v3.4.0\bin\bareun.exe -unreg 발급받은-API-키

2. 실행 멈추기

리눅스·맥OS에서 nohup으로 실행했다면 다음 명령으로 멈춥니다.

pkill -f "$BAREUN_ROOT/bin/bareun"

윈도우에서는 바른을 실행한 명령 창을 닫거나, 다음 명령으로 멈춥니다.

taskkill /IM bareun.exe /F

윈도우에서 bareun.exe -svc=install로 서비스를 직접 등록했다면, 관리자 권한 명령 프롬프트에서 서비스를 멈추고 등록을 해제합니다.

c:\Users\me\bareun-v3.4.0\bin\bareun.exe -svc=stop
c:\Users\me\bareun-v3.4.0\bin\bareun.exe -svc=remove

리눅스·맥OS에서 systemd 나 launchd 에 직접 서비스로 등록했다면, 그 서비스도 멈추고 등록 파일을 지우세요.

3. 폴더 지우기

사용자 사전과 라이선스를 보존하려면 먼저 설치 폴더의 var/custom-dict 폴더와 var/license.pem을 다른 곳에 복사해 두세요. 그다음 설치 폴더를 통째로 지웁니다.

# 리눅스·맥OS (설치 문서의 예시 경로)
rm -rf ~/bareun-v3.4.0

rem 윈도우 (설치 문서의 예시 경로)
rmdir /s /q c:\Users\me\bareun-v3.4.0

4. 환경 변수 지우기

리눅스·맥OS: 설치할 때 ~/.bashrc(zsh 를 쓰면 ~/.zshrc)에 넣은 BAREUN_ROOT, PATH, LD_LIBRARY_PATH 설정 줄을 지우고 터미널을 새로 엽니다.
윈도우: setx로 등록한 BAREUN_ROOT를 지웁니다.
```
reg delete HKCU\Environment /v BAREUN_ROOT /f
```
PATH에 바른의 bin 폴더를 추가했다면, 시스템 속성 > 고급 > 환경 변수에서 사용자 변수 Path를 열어 그 항목을 지웁니다.

5. 제거 확인하기

# 리눅스·맥OS: 새 터미널에서 실행합니다.
echo $BAREUN_ROOT                          # 빈 줄이 나오면 환경 변수가 지워졌습니다.
ss -ltn | grep 5656                        # 리눅스. 아무것도 나오지 않으면 5656 포트를 쓰는 프로그램이 없습니다.
lsof -nP -iTCP:5656 -sTCP:LISTEN           # 맥OS. 아무것도 나오지 않으면 5656 포트를 쓰는 프로그램이 없습니다.

rem 윈도우: 새 명령 프롬프트 창에서 실행합니다.
echo %BAREUN_ROOT%
netstat -ano | findstr :5656

윈도우에서 echo %BAREUN_ROOT%가 %BAREUN_ROOT%를 그대로 출력하고 netstat 결과가 비어 있으면 제거가 끝난 것입니다.

도커로 설치한 경우

도커로 설치한 경우에는 컨테이너를 멈추고 지운 뒤 이미지를 지웁니다. 데이터는 컨테이너를 실행할 때 연결한 폴더(설치 문서의 예시는 ~/bareun/var)에 남으므로, 완전히 지우려면 이 폴더도 지웁니다.

docker rm -f bareun
docker rmi bareunai/bareun:latest
rm -rf ~/bareun/var

자주 묻는 질문

Q. `apt remove`와 `apt purge` 중 무엇을 써야 하나요?

어느 쪽을 써도 결과가 같습니다. 바른 패키지는 따로 관리하는 설정 파일이 없기 때문입니다. 두 명령 모두 /opt/bareun/var 폴더(모델·사용자 사전·로그·라이선스·API 키 정보)는 남기므로, 완전히 지우려면 sudo rm -rf /opt/bareun을 이어서 실행하세요.

Q. 제거한 뒤 다시 설치했더니 API 키 등록이 "Other key is registered" 오류로 실패해요.

지우지 않고 남겨 둔 var 폴더에 이전에 등록한 API 키 정보(api-keys.db.pb)가 남아 있어서입니다. 이전 키로 bareun -unreg 이전-API-키를 실행해 등록을 해제한 뒤 다시 등록하세요. 이전 키를 모르면 서비스를 멈추고 var 폴더의 api-keys.db.pb 파일을 지운 뒤 등록하면 됩니다.

Q. 다시 설치하면 모델을 또 내려받나요?

var/models 폴더를 지웠다면 서버를 처음 실행할 때 모델을 다시 내려받습니다. 폴더를 남겨 두었다면 새 버전에 맞는 모델이 이미 있을 때 그대로 쓰고, 없을 때만 새로 받습니다.

Q. 윈도우에서 제거가 끝난 뒤 재시작하라고 나와요.

바른 서비스가 실행 중인 상태에서 제거했기 때문입니다. 재시작하면 제거가 마무리됩니다. 재시작 없이 지우려면 제거하기 전에 관리자 권한 명령 프롬프트에서 sc stop bareunsvc로 서비스를 멈추세요.

Q. 사용자 사전을 보존하려면 무엇을 백업해야 하나요?

단어 목록 원본을 보관해 두었다가 새로 설치한 뒤 UpdateCustomDictionary API로 다시 등록하는 방법을 권장합니다. 같은 컴퓨터에 다시 설치해 그대로 쓰려면 제거하기 전에 var/custom-dict 폴더를 복사해 두세요. 라이선스 파일(var/license.pem)도 함께 복사해 두면 좋습니다.

바른 삭제하기

설치 방식별 위치 한눈에 보기

지우기 전에 백업할 것

설치 방식별 삭제 방법

자주 묻는 질문

Q. apt remove와 apt purge 중 무엇을 써야 하나요?

Q. 제거한 뒤 다시 설치했더니 API 키 등록이 "Other key is registered" 오류로 실패해요.

Q. 다시 설치하면 모델을 또 내려받나요?

Q. 윈도우에서 제거가 끝난 뒤 재시작하라고 나와요.

Q. 사용자 사전을 보존하려면 무엇을 백업해야 하나요?

Q. `apt remove`와 `apt purge` 중 무엇을 써야 하나요?