Ghost 블로그 설치 (Node.js v22), nvm install 22.13.1

 

Ghost의 최신 버전(예: v5.110.0 이상)에서는 지원되는 Node.js 버전이 다음과 같이 명시되어 있습니다:

 

• ^18.12.1
• ^20.11.1
• ^22.13.1

 

 

즉, 만약 Node.js v22 계열을 사용하려면 최소 v22.13.1 이상이어야 합니다. Ghost는 Ghost(Pro)에서 실제로 사용되는 추천 버전을 기준으로 테스트되므로, 최신 Ghost 버전에서는 안정성과 성능을 위해 위 세 가지 옵션 중 하나를 사용하도록 권장합니다.

아래는 Windows 환경에서 nvm을 사용하여 Node.js v22.13.1 이상을 설치하는 방법입니다.

---

1. nvm for Windows 설치 확인 및 업데이트

1. nvm-windows GitHub Releases 페이지에서 최신 설치 파일(nvm-setup.exe)을 다운로드하고 설치합니다.
2. 관리자 권한으로 명령 프롬프트(cmd)나 PowerShell을 열어 다음 명령어로 nvm 버전을 확인합니다:

   nvm -v

---

2. Node.js v22.13.1 설치 및 활성화

Ghost에서 Node.js v22를 사용하려면 최소 v22.13.1 이상이어야 하므로, nvm을 통해 해당 버전을 설치합니다.

 

1. Node.js v22.13.1 설치:참고: 설치 가능한 최신 v22 버전이 있다면 Ghost 요구 사항에 맞게 해당 버전을 선택하세요.
   • nvm install 22.13.1
2. 설치한 Node.js 버전 활성화:
   • nvm use 22.13.1
3. 활성화된 Node.js 버전을 확인:
   • node -v
   • npm -v

---

3. Ghost CLI 설치 및 Ghost 설치

1. Ghost CLI를 전역으로 설치합니다:관리자 권한이 필요한 경우 관리자 모드로 실행합니다.
   • npm install -g ghost-cli
2. Ghost를 설치할 디렉터리를 생성하고 해당 디렉터리로 이동합니다. 예를 들어:
   • mkdir C:\ghost-blog
   • cd C:\ghost-blog
3. Ghost를 로컬 설치합니다(예: SQLite를 사용하는 로컬 설치):
   • ghost install local

---

4. Ghost 실행 및 확인

1. Ghost가 자동으로 실행되지 않은 경우, 다음 명령어로 시작합니다:
   • ghost start
2. 웹 브라우저에서 아래 주소로 접속하여 Ghost 블로그와 관리자 패널이 정상적으로 동작하는지 확인합니다:
   • 블로그: http://localhost:2368
   • 관리자 패널: http://localhost:2368/ghost

---

결론

Ghost CMS의 최신 버전은 Node.js의 최소 요구 버전으로 v22 계열을 선택할 경우 최소 v22.13.1 이상을 필요로 합니다. 따라서 Ghost를 최신 환경에서 원활하게 실행하기 위해서는 nvm을 사용하여 Node.js v22.13.1 이상으로 업데이트 한 후 Ghost CLI를 통해 Ghost를 설치 및 실행해야 합니다.

 

출처: (Ghost 공식 문서 – Supported Node versions)

또한 DigitalOcean 커뮤니티 게시물 등 여러 사례에서 Ghost 업데이트 시 최소 요구 Node 버전으로 ^18.12.1, ^20.11.1, 또는 ^22.13.1을 요구하고 있음을 확인할 수 있습니다.

 

이 과정대로 진행하면 Ghost에서 요구하는 최소 Node 버전(v22.13.1 이상)을 충족하여 최신 Ghost CMS를 문제없이 설치하고 실행할 수 있습니다.