jointrashposs/content/ko-KR/docs/install/manual.md

Misskey 수동 설치 가이드

이 가이드에서는 Misskey의 설치 및 준비 방법에 대해 설명합니다.

::: danger 한 번 사용을 시작한 인스턴스의 도메인 호스트 이름은 절대 변경하지 마세요! :::

::: tip 준비사항 다음을 미리 설치해주세요:

• Node.js 20.4 이상
• PostgreSQL 15 이상
• Redis
• FFmpeg

GNU/Linux 환경이면 build-essential 패키지를 설치해 두면 좋습니다.

또한 corepack이 활성화되어 있어야 합니다.

sudo corepack enable

:::

사용자 생성

root로 Misskey를 실행하는 것은 좋은 생각이 아닙니다. 별도의 사용자를 만들어 설치하는 것이 좋습니다.

adduser --disabled-password --disabled-login misskey

Misskey 설치

위에서 생성한 사용자로 전환해 Misskey 설치를 시작합니다.

sudo -iu misskey
git clone --recursive https://github.com/misskey-dev/misskey.git
cd misskey
git checkout master
git submodule update --init
NODE_ENV=production pnpm install --frozen-lockfile

Misskey 설정

설정 예시 파일(.config/example.yml)을 복사해 default.yml 파일을 만듭니다.

cp .config/example.yml .config/default.yml

텍스트 편집기를 이용해 default.yml 파일을 열어, 파일 내의 지시에 따라 수정합니다.

Misskey 빌드 및 초기화

다음 명령을 실행해 Misskey를 빌드(pnpm run build)하고 데이터베이스를 초기화(pnpm run init)합니다. 본 작업은 시간이 소요되는 작업입니다.

NODE_ENV=production pnpm run build
pnpm run init

Misskey 실행

Misskey의 실행을 위한 모든 준비가 끝났습니다. 이제 다음 명령을 통해 Misskey를 실행할 수 있습니다.

NODE_ENV=production pnpm run start

details systemd를 이용한 관리

우선 systemd 서비스 파일을 생성합니다.

/etc/systemd/system/misskey.service 파일을 에디터로 열고 아래 코드를 작성해 넣습니다.

[Unit]
Description=Misskey daemon

[Service]
Type=simple
User=misskey
ExecStart=/usr/bin/npm start
WorkingDirectory=/home/misskey/misskey
Environment="NODE_ENV=production"
TimeoutSec=60
StandardOutput=journal
StandardError=journal
SysLogIdentifier=misskey
Restart=always

[Install]
WantedBy=multi-user.target

::: warning CentOS에서 1024 이하의 포트를 이용해 Misskey를 실행하는 경우 ExecStart=/usr/bin/sudo/usr/bin/npm start로 변경해야 합니다. :::

이제 systemd를 다시 시작해 서비스를 활성화합니다.

sudo systemctl daemon-reload
sudo systemctl enable misskey

이렇게 하면 Misskey 서비스를 부팅할 수 있습니다.

sudo systemctl start misskey

::: tip 이제 systemctl status misskey 명령어로 Misskey의 서비스 상태를 확인할 수 있습니다. :::

Misskey 업데이트 방법

::: warning 업데이트 시 반드시 변경사항를 확인하고 변경사항이나 필요한 추가 작업을 미리 확인해 주십시오. :::

master를 다시 풇하고 설치, 빌드, DB 마이그레이션을 실시합니다.

git checkout master
git pull
git submodule update --init
NODE_ENV=production pnpm install --frozen-lockfile
NODE_ENV=production pnpm run build
pnpm run migrate

업데이트의 내용 및 DB 규모에 따라 시간이 소요될 수 있습니다.

업데이트가 완료되는 대로 Misskey를 다시 시작합니다.

sudo systemctl restart misskey

::: tip 빌드 혹은 실행 중 오류가 발생한 경우 아래 명령을 실행해보세요.

• pnpm run clean 또는 pnpm run clean-all
  • 이 명령을 실행한 후에는 반드시 pnpm install을 다시 실행해주세요.
• pnpm rebuild :::