Stash를 Windows 서비스로 설정하는 방법

Source: Dev.to

Note

패키지 이름이 Stash인 것이 여러 개 있습니다. 이 가이드는 Stash 애플리케이션에 대한 것입니다.

Stash는 독립 실행 파일 형태로 제공됩니다. 아래 단계에서는 이를 Windows 서비스로 전환하여 로그인 시(가능하면 그 이전에도) 자동으로 실행되도록 하는 방법을 설명합니다.

Step 1: Download Stash

최신 stash‑win.exe 파일을 Stash releases page에서 다운로드한 뒤 C:\Program Files\stash에 넣습니다.
다른 위치에 두어도 되지만, Program Files에 두면 관리자 권한이 없는 작업으로부터 실행 파일을 최대한 보호할 수 있습니다.

브라우저는 보통 Program Files에 직접 쓸 수 없으므로, 먼저 임시 폴더에 다운로드한 뒤 파일 관리자를 이용해 최종 위치로 이동해야 할 수도 있습니다.

Step 2: Install Servy

Servy를 GitHub releases page에서 다운로드하여 설치합니다.
net이 아닌 설치 프로그램을 사용하는 것이 권장됩니다.

Step 3: Perform initial Stash service setup

1. Servy를 실행합니다.

2. Main 탭에서 필수 항목을 입력합니다:

   • Service Name * – 설명이 가능한 이름을 선택합니다.
   • Display Name – 선택 사항이지만 나중에 식별하기 편합니다.
   • Service Description – 선택 사항 설명.
   • Process Path * – 1단계에서 넣은 stash‑win.exe를 찾아 지정합니다.

3. 기본적으로 서비스는 SYSTEM 계정으로 실행되는데, 이는 앱이 손상될 경우 위험합니다. Log On 탭으로 이동해 User Account 라디오 버튼을 선택하고 Windows 사용자 이름과 비밀번호(비밀번호와 확인 비밀번호 모두)를 입력합니다.

Step 4: Grant %ProgramData%\Servy permissions to your Windows user account

1. 파일 탐색기를 열고 주소 표시줄에 %ProgramData%를 입력한 뒤 Enter를 누릅니다.

2. Servy 폴더를 찾아 오른쪽 클릭 → Properties → Security → **Edit…**를 선택합니다.

3. **Add…**를 클릭하고 Enter the object names to select 필드에 Windows 사용자 이름을 입력한 뒤 OK를 누릅니다.

4. 목록에서 해당 사용자 계정을 선택하고 Allow 아래의 다음 권한이 체크되어 있는지 확인합니다:

   • Read & execute
   • List folder contents
   • Read
   • Write

5. Apply를 클릭하고, OK를 눌러 대화 상자를 닫습니다.

Step 5: Finalize Stash service setup

Servy 창으로 돌아가 Install를 클릭합니다. 서비스가 설치되었다는 확인 메시지가 뜰 때까지 기다립니다.

Step 6: Verify the service installation

1. 서비스 관리자를 엽니다: Start → services 입력 → Services 결과(톱니바퀴 아이콘)를 선택합니다.
2. 3단계에서 만든 항목을 찾아 선택한 뒤 왼쪽 패널에서 Start를 클릭합니다.
3. 서비스가 시작되면 웹 브라우저를 열고 http://localhost:9999에 접속합니다. Stash UI가 표시되어야 합니다.

Removing the service (if you need to start over)

관리자 권한으로 PowerShell 프롬프트를 엽니다: Start → PowerShell 입력 → 최신 버전을 오른쪽 클릭 → Run as administrator. 그런 다음 다음 명령을 실행합니다:

Remove-Service -Name "ServiceNameYouChoseInStep3"

이 명령은 Windows에서 서비스를 삭제하므로, 다시 설정을 시작할 수 있습니다.

Credits

초기 설정 안내를 제공해 준 zimanninetynine에게 감사드립니다. (원본: initial setup instructions)