시작하기 전에

1. 권장 기준

설치 스크립트가 지원하는 환경은 아래 한 줄이 전부입니다. 그 밖의 환경에서는 설치가 시작되지 않고 멈춥니다.

지원: Ubuntu 22.04 · 24.04 LTS · x86_64 · systemd

WattWorks가 권장하는 서버 기준입니다.

• OS — Ubuntu 22.04 또는 24.04 LTS
• GPU VRAM — 16GB 이상
• CPU — GPU당 1코어 (권장 4코어)
• RAM — GPU당 4GB (권장 32GB)
• 디스크 — GPU당 128GB (권장 1TB). 제공 용량은 Data 파티션에서 200GB를 뺀 크기이고, XFS여야 합니다. 자세한 준비는 「디스크 준비」에 있습니다.
• 템플릿 이미지 — 등록(활성화) 직후 서버가 공식 템플릿 이미지를 자동으로 받습니다. 디스크 약 70GB(공유 레이어 덕에 실사용은 더 작습니다)와 회선(데이터센터 27분 · 가정 회선은 더 걸립니다)을 씁니다. 공급자가 할 일은 없습니다.
• 네트워크 — VRAM 1GiB당 2.6Mbps (하한 100Mbps · 상한 500Mbps)
• 포트 — 인스턴스용 범위(기본 30000-31000)와 노드 HTTPS 30443
• CUDA — 12.0 이상

2. 선행 조건 — 드라이버 · Docker · Container Toolkit · Caddy

새로 설치하는 서버에서는 설치 스크립트가 NVIDIA 드라이버 · Docker · NVIDIA Container Toolkit · Caddy를 확인하고, Docker · Container Toolkit · Caddy는 없으면 직접 설치합니다. NVIDIA 드라이버는 설치하지 않습니다 — 없으면 아래 명령을 화면에 안내하고 멈춥니다(종료 코드 18). 이것은 실패가 아닙니다. 이미 등록된 서버에서 다시 실행하면(업데이트) 설치하지 않고 확인만 합니다.

안내한 명령을 직접 실행하면 Ubuntu 공식 저장소의 드라이버 패키지가 설치되고 재부팅합니다. 재부팅한 뒤 같은 설치 명령을 그대로 다시 실행하면 드라이버는 「있음」으로 지나가고, 이미 설치된 것은 건너뛰고 이어서 진행합니다. 드라이버 패키지는 있는데 커널 모듈이 올라오지 않은 서버(재부팅 전에 다시 실행한 경우 등)에서는 sudo reboot를 안내하고 멈춥니다(종료 코드 16) — 이것도 실패가 아닙니다. Docker · Container Toolkit · Caddy가 없는데 자동 설치도 실패하면 원인을 화면에 출력하고 멈춥니다(종료 코드 5). 세 경우 모두 등록 토큰은 쓰이지 않습니다 — 발급 후 24시간 안에 다시 실행하세요.

• NVIDIA 드라이버 — nvidia-smi -L이 GPU를 1장 이상 보여 줘야 합니다.
• Docker — docker info가 성공해야 합니다.
• NVIDIA Container Toolkit — docker info의 런타임 목록에 nvidia가 있어야 합니다.
• Caddy — 스크립트가 설치 여부를 확인합니다.

NVIDIA 드라이버는 아래 명령으로 직접 설치합니다(스크립트가 같은 글자를 안내합니다). Docker · Container Toolkit은 자동 설치가 실패했거나 미리 직접 설치하려면 아래 명령을 씁니다.

sudo apt-get update && sudo apt-get install -y ubuntu-drivers-common
sudo ubuntu-drivers --gpgpu install && sudo reboot

sudo apt-get update && sudo apt-get install -y docker.io
sudo systemctl enable --now docker

curl -fsSL https://nvidia.github.io/libnvidia-container/gpgkey | sudo gpg --dearmor -o /usr/share/keyrings/nvidia-container-toolkit-keyring.gpg && sudo chmod 0644 /usr/share/keyrings/nvidia-container-toolkit-keyring.gpg
curl -fsSL https://nvidia.github.io/libnvidia-container/stable/deb/nvidia-container-toolkit.list | sed 's#deb https://#deb [signed-by=/usr/share/keyrings/nvidia-container-toolkit-keyring.gpg] https://#g' | sudo tee /etc/apt/sources.list.d/nvidia-container-toolkit.list
sudo apt-get update && sudo apt-get install -y nvidia-container-toolkit
sudo nvidia-ctk runtime configure --runtime=docker && sudo systemctl restart docker

3. 서버 방화벽 — ufw · firewalld

ufw나 firewalld가 켜져 있으면 설치 스크립트가 멈춥니다(종료 코드 6). 이 도구들과 설치 스크립트가 같은 iptables 테이블을 다루기 때문입니다. 스크립트는 이 도구들을 자동으로 끄지 않습니다 — 비활성화하거나 운영팀에 문의하세요.

설치 스크립트는 WattWorks 전용 iptables 체인만 추가합니다. 서버에 이미 있는 INPUT 정책과 규칙(SSH 허용 등)은 바꾸지 않으므로, 서버 자체의 방화벽 강화는 공급자가 맡습니다.

설치 스크립트가 추가하는 규칙 — 보안 안내

4. 네트워크 — 공인 IP · 포트 · 바깥 연결

고객이 인스턴스에 접속하려면 아래 셋이 필요합니다.

• 고정 공인 IP — 접속 주소가 바뀌면 고객이 접속할 수 없습니다.
• 포트 포워딩 — 공유기나 클라우드 보안 그룹에서 인스턴스용 포트 범위와 30443을 이 서버로 넘겨야 합니다. 포트가 열려 있지 않으면 고객이 접속할 수 없습니다.
• 개방 포트 GPU당 3개 이상 — 이보다 적으면 등록이 보류되고 판매를 시작할 수 없습니다.

설치하는 동안 서버가 WattWorks로 나가는 연결도 필요합니다. 스크립트가 컨트롤 플레인에 닿지 못하면 멈춥니다(종료 코드 9) — DNS · 나가는 방향의 방화벽 · 프록시 · 서버 시계를 확인하세요.

포트 포워딩

5. 신청과 노드 추가

1. 콘솔 「공급자 신청」에서 신청합니다. 휴대폰 본인확인을 마친 계정만 신청할 수 있습니다.
2. 운영팀이 신청 내용을 확인합니다. 결과는 메일로 알려 드립니다.
3. 승인되면 콘솔 「서버 관리」 → 「노드 추가」에서 서버마다 설치 명령을 받습니다. 명령은 한 번만 보이고 24시간 동안 유효합니다.
4. 명령을 서버에서 실행합니다. 등록이 끝나면 GPU 슬롯이 판매 일시중지 상태로 만들어지고, 콘솔에서 가격을 확인하면 공개됩니다.