설치하기
이 장에서 배우는 것 설치 명령 한 줄, 설치 중 물어보는 것들, 그리고 무엇이 어디에 설치되는지.
한 줄
터미널(macOS·Linux) 또는 PowerShell(Windows)에 붙여넣으세요.
받아서 바로 쓸 수 있는 상태로 들어갑니다. 따로 빌드하거나 조립하는 과정이 없습니다.
설치 중에 물어보는 것
1. 접속 주소
브라우저로 접속할 주소입니다. 기본값은 이렇습니다.
특별한 이유가 없으면 기본값을 쓰세요. 그 번호가 이미 다른 프로그램에 쓰이고 있다면 바꾸라고 안내가 나옵니다.
2. 비밀번호
접속할 때 입력할 비밀번호입니다.
지금은 내 컴퓨터에서만 열리지만 비밀번호를 정해두세요. 나중에 밖에서 접속하게 되면 그 순간부터 이 비밀번호가 유일한 문입니다.
잊어버려도 hyperteams setup으로 다시 정할 수 있습니다.
무엇이 어디에 설치되나
| 위치 | |
|---|---|
| 프로그램 파일 | 설치 폴더 (설치 중 안내됨) |
| 실행 명령 | hyperteams — 어느 폴더에서든 실행 가능 |
| 데이터베이스 | 설치 폴더 안. 대화와 사용량 기록 |
| 설정 | .env.local |
| 로그 | logs/server.log |
내 작업 폴더에는 아무것도 안 만듭니다. 하이퍼팀즈(HyperTeams)는 작업 폴더의 경로만 기억하고, 그 안에 자기 파일을 넣지 않습니다.
설치 확인
버전이 나오면 설치 완료입니다.
command not found가 나오면 준비물 장에서와 같습니다 — 새 터미널 창을 열어 다시 해보세요.
다른 주소로 설치하고 싶다면
기본 번호(27777)가 이미 쓰이고 있다면 실행할 때 바꿀 수 있습니다.
설치를 다시 할 필요는 없습니다. 실행할 때마다 지정하거나,
hyperteams setup으로 기본값을 바꾸면 됩니다.
업데이트는 재설치가 아닙니다
중요합니다. 새 버전이 나와도 설치 스크립트를 다시 돌리지 마세요.
upgrade는 프로그램 파일만 바꿉니다. 기록·설정·연결해둔 주소는 그대로
남습니다. 재설치하면 그것들이 어떻게 될지 보장되지 않습니다.
자주 막히는 곳
"curl: command not found" (Windows)
Windows에서는 PowerShell 명령을 쓰세요. curl 쪽은 macOS·Linux용입니다.
회사 네트워크에서 다운로드가 막힙니다
프록시나 방화벽 때문일 수 있습니다. IT 담당자에게 hyperteams.net 접근 허용을
요청하시거나, 설치 스크립트를 받아서 내용을 확인한 뒤 실행할 수도 있습니다.
설치는 됐는데 실행이 안 됩니다
다음 장에서 첫 실행을 단계별로 다룹니다.
확인
1. 설치 중에 물어보는 두 가지는?
답
접속 주소(기본 http://localhost:27777)와 비밀번호입니다. 비밀번호는 지금은
내 컴퓨터에서만 열리더라도 정해두는 게 좋습니다 — 나중에 밖에서 접속하게 되면
그것이 유일한 문이 됩니다.
2. 새 버전이 나왔을 때 설치 스크립트를 다시 돌리면 안 되는 이유는?
답
hyperteams upgrade는 프로그램 파일만 바꾸고 기록·설정·연결한 주소를
보존하지만, 재설치는 그것들이 어떻게 될지 보장되지 않습니다.
3. HyperTeams가 내 작업 폴더에 파일을 만듭니까?
답
아니요. 작업 폴더의 경로만 기억하고, 자기 파일(DB·설정·로그)은 설치 폴더에 둡니다.
이제 켜봅니다 → 처음 켜고 접속하기