Linux 서버
root 권한 없이 Linux 서버에 Octoboard 서버 프로그램인 octoboardd(앱에서는 ‘데몬’이라고 부릅니다)를 설치합니다. macOS나 Windows 앱 또는 브라우저에서 SSH를 통해 접속합니다.
x86_64와 aarch64를 지원하며, 배포판은 상관없습니다.
시작하기 전에
섹션 제목: “시작하기 전에”- SSH로 로그인할 수 있는 Linux 서버. SSH는 다른 컴퓨터에 안전하게 로그인해서 명령을 입력하는 방법입니다. 서버 제공업체가 서버 주소와 사용자 이름을 알려 줍니다.
- 내 컴퓨터에 설치한 Octoboard 앱(macOS 또는 Windows). 데스크톱 앱에서 작업하려는 경우에 필요합니다(권장).
로그인하려면 내 컴퓨터에서 터미널(macOS) 또는 PowerShell(Windows)을 열고 아래 명령을 실행하세요. <you> 자리에는 사용자 이름을, <server> 자리에는 서버 주소를 넣습니다. 처음에는 서버를 신뢰할지 물으면 yes라고 답하세요.
ssh <you>@<server>아래 1단계와 2단계는 서버에서, 방금 로그인한 그 창에서 실행합니다.
-
서버에 octoboardd를 설치하세요.
Terminal window curl --proto '=https' --tlsv1.2 -fsSL https://octoboard.dev/install.sh | shInstalled octoboardd로 시작하는 줄이 출력됩니다. -
서버에서 octoboardd를 시작하세요.
Terminal window octoboardd startOctoboard started로 시작하는 줄이 출력됩니다. -
내 컴퓨터에서 다음 두 방법 중 하나로 연결하세요.
-
데스크톱 앱에서(권장): SSH 가이드의 Linux 서버에 연결하기를 따라 하세요.
-
브라우저에서: 서버에서 다음을 실행하세요.
Terminal window octoboardd address두 가지가 출력됩니다.
http://127.0.0.1:로 시작하는 브라우저 주소와ssh명령입니다. 내 컴퓨터에서ssh명령을 복사하고,<server>을(를) 서버 주소(서버에 로그인할 때 쓰는 IP 주소나 이름)로 바꾼 다음 터미널이나 PowerShell에서 실행하세요. 비밀번호를 물을 수 있고, 그 뒤에는 아무것도 표시되지 않는데 정상입니다. 그 창은 열어 두세요. 닫으면 연결이 끊어집니다. 그런 다음 출력된 주소를 브라우저에서 여세요.
-
데스크톱 앱의 새 창이나 브라우저 탭에서 Octoboard이(가) 열리면 성공입니다.
octoboardd를 찾을 수 없다면
섹션 제목: “octoboardd를 찾을 수 없다면”설치 중에 .local/bin으로 끝나는 폴더(예: /home/<you>/.local/bin)가 PATH에 없다고 나오면, 셸이 이름만으로는 octoboardd를 찾지 못한다는 뜻입니다. 설치 중에 출력된 전체 경로로 실행하거나, ~/.local/bin을(를) PATH에 추가한(예: ~/.profile에) 다음 다시 로그인하세요.
로그아웃하거나 재부팅한 뒤에도 계속 실행하기
섹션 제목: “로그아웃하거나 재부팅한 뒤에도 계속 실행하기”octoboardd start(으)로 시작한 octoboardd는 서버가 재시작되면 멈추고, 저절로 다시 시작되지 않습니다. octoboardd start을(를) 다시 실행하거나, 시작해 주겠다고 제안하는 데스크톱 앱에서 연결하세요. 로그아웃하면 멈추는 서버도 있습니다.
서버가 시작될 때마다 함께 시작되고 로그아웃한 뒤에도 계속 실행되게 하려면, 대신 서비스로 설치하세요.
curl --proto '=https' --tlsv1.2 -fsSL https://octoboard.dev/install.sh | sh -s -- --service이 명령은 프로그램을 설치하고, systemd 사용자 서비스로 설정하고, 시작합니다. 그런 다음 로그인하지 않은 동안에도 서비스가 실행되게 해 주는 lingering을 켭니다. 켜지 못했다는 메시지가 나오면 다음을 한 번 실행하세요(sudo가 필요할 수 있습니다).
loginctl enable-linger "$USER"기본 포트는 3369입니다. 다른 포트를 쓰려면 서비스 명령 끝이나 octoboardd start에 --port <port>을(를) 덧붙이세요.
업그레이드
섹션 제목: “업그레이드”Octoboard은(는) 스스로 업그레이드하지 않습니다. 새 버전이 나오면 브라우저가 알려 주고, 설치할 시점은 직접 정합니다. 새 버전을 설치하고 나면 중단되는 세션이 없을 때 Octoboard이(가) 알아서 새 버전으로 다시 시작하며, 중단되는 세션이 있으면 목록을 보여 주고 먼저 물어봅니다.
-
브라우저에서: 새 버전이 있다는 안내에서 다운로드 및 설치를 누르세요.
-
서버에서: 다음 명령을 실행하세요.
Terminal window octoboardd update지금 다시 시작할지 물으면
y라고 답해 다시 시작하거나, Enter를 눌러 일단 이전 버전을 계속 실행하세요. 나중에 다시 시작하려면octoboardd restart을(를) 실행하세요.
octoboardd update이(가) 프로그램을 교체할 수 없다고 하면(예: 쓰기 권한이 없는 곳에 설치된 경우), 대신 설치 명령(또는 서비스 명령)을 다시 실행하세요. 안전할 때는 같은 방식으로 다시 시작하고, 그렇지 않으면 octoboardd restart을(를) 실행하라고 알려 줍니다.