설치 가이드¶

Backend.AI GO는 주요 데스크톱 운영체제와 iOS를 모두 지원합니다. 사용 중인 플랫폼에 맞는 지침을 따르세요.

macOS (Apple Silicon 전용)¶

Backend.AI GO는 Apple Silicon (M1/M2/M3/M4/M5 칩) 환경을 위해 설계되었으며, Intel 기반 Mac은 지원하지 않습니다.

1. .dmg 파일을 다운로드합니다 (예: backend-ai-go-0.9.0-macos-arm64.dmg).
2. .dmg 파일을 더블 클릭하여 마운트합니다.
3. Backend.AI GO 아이콘을 응용 프로그램(Applications) 폴더로 드래그합니다.
4. 응용 프로그램 폴더나 Spotlight를 통해 앱을 실행합니다.

Windows¶

Backend.AI GO는 Windows 10 및 11(64비트)을 지원합니다.

1. .exe (NSIS) 패키지를 다운로드합니다.
2. 설치 프로그램을 실행하고 화면의 지시에 따릅니다.
3. 앱은 'Program Files'에 설치되며 바탕 화면에 바로가기가 생성됩니다.
4. Backend.AI GO를 실행합니다.

Linux¶

x64 및 ARM64 아키텍처용 패키지를 제공합니다.

AppImage (한 줄 설치)¶

내려받은 AppImage에는 실행 권한이 붙지 않습니다. 그래서 더블클릭하면 암호 입력창만 뜨고 아무 일도 일어나지 않습니다. 아래 명령은 실행 권한을 준 상태로 설치하고 애플리케이션 메뉴 항목과 아이콘까지 함께 등록합니다.

curl -fsSL https://go.backend.ai/install.sh | sh -s -- --desktop

AppImage는 ~/.aigo/bin/backend-ai-go.AppImage에, 메뉴 항목은 ~/.local/share/applications/ai.backend.go.desktop에, 아이콘은 ~/.local/share/icons/hicolor/256x256/apps/에 놓입니다. 셋 다 무엇을 쓰기 전에 릴리스의 SHA256SUMS.txt로 검증하며, --uninstall은 셋을 모두 지웁니다. 이미 로그인해 있던 세션이라면 메뉴에 항목이 나타나기까지 다시 로그인해야 할 수 있습니다.

AppImage는 실행할 때 FUSE 2로 자기 페이로드를 마운트합니다. 앱이 바로 종료된다면 AppImage가 실행되지 않음을 참고하세요.

Debian/Ubuntu (.deb)¶

x64 (Intel/AMD):

1. .deb 패키지를 다운로드합니다 (예: backend-ai-go-x.x.x-linux-x64.deb).
2. 터미널에서 다음 명령으로 설치합니다:

   sudo dpkg -i backend-ai-go-x.x.x-linux-x64.deb
   sudo apt-get install -f  # 누락된 의존성 패키지 설치
   

ARM64 (Raspberry Pi 5, NVIDIA Jetson 등):

1. ARM64용 .deb 패키지를 다운로드합니다 (예: backend-ai-go-x.x.x-linux-arm64.deb).
2. 터미널에서 다음 명령으로 설치합니다:

   sudo dpkg -i backend-ai-go-x.x.x-linux-arm64.deb
   sudo apt-get install -f  # 누락된 의존성 패키지 설치
   

Flatpak (x64 전용)¶

Flatpak은 대부분의 Linux 배포판에서 작동하는 샌드박스 환경을 제공합니다.

1. .flatpak 번들을 다운로드합니다.
2. 다음 명령으로 설치합니다:

   flatpak install backend-ai-go-x.x.x-linux-x64.flatpak
   

3. 애플리케이션을 실행합니다:

   flatpak run ai.backend.go
   

한 줄 설치 (CLI 및 서버)¶

위 패키지들은 데스크톱 앱을 설치합니다. 화면이 없는 서버나 컨테이너, CI 러너에서는 aigo CLI와 헤드리스 aigo-server를 대신 설치하세요.

curl -fsSL https://go.backend.ai/install.sh | sh

irm https://go.backend.ai/install.ps1 | iex

두 바이너리는 ~/.aigo/bin에 설치되고, 셸 시작 파일에 관리되는 블록 하나가 추가되어 해당 경로가 PATH에 등록됩니다. aigo-server는 /v1 요청을 라우팅하는 continuum-router와 짝이 되는 model-metadata.yaml도 함께 가져오며, 서버가 이 둘을 찾는 위치가 같은 디렉터리이므로 나란히 설치됩니다. 파일을 쓰기 전에 모든 아카이브를 릴리스의 SHA256SUMS.txt로 검증하며, 이 검증을 건너뛰는 옵션은 없습니다. 같은 명령을 다시 실행하면 그 자리에서 업그레이드됩니다.

Windows 스크립트는 CLI만 설치합니다. aigo-server의 Windows 빌드는 없고, 데스크톱 앱은 별도의 서명된 설치 파일을 제공합니다.

옵션 전달¶

파이프로 실행하는 스크립트는 sh -s -- 뒤에 인자를 받습니다.

curl -fsSL https://go.backend.ai/install.sh | sh -s -- --cli-only -y

iex는 파라미터를 전달할 수 없으므로, PowerShell 스크립트에는 스크립트 블록으로 전달합니다.

& ([scriptblock]::Create((irm https://go.backend.ai/install.ps1))) -NoPathUpdate

사용 가능한 파라미터는 -Version, -Channel, -InstallDir, -NoPathUpdate, -DryRun, -Uninstall입니다.

systemd 서비스로 설치¶

curl -fsSL https://go.backend.ai/install.sh | sudo sh -s -- --system

두 바이너리를 /usr/local/bin에 설치하고, aigo 서비스 계정을 만들고, /etc/aigo, /var/lib/aigo, /var/log/aigo를 준비하고, systemd 유닛과 preset, logrotate 설정을 설치합니다. /etc/aigo/config.toml이 없으면 생성하고, 서비스를 활성화하되 시작하지는 않습니다.

systemd 유닛과 preset, logrotate 설정, 환경 변수 템플릿은 함께 배포되는 체크섬 매니페스트로 검증한 뒤에야 /etc에 씁니다. 릴리스 바이너리와 마찬가지로 건너뛸 수 없는 필수 검증입니다. 두 바이너리 역시 셸 시작 파일이나 systemd 유닛을 건드리기 전에 먼저 실행해 정상 동작을 확인합니다. 이 시스템에서 실행할 수 없는 바이너리라면 설치가 어중간하게 남는 대신 그 자리에서 깔끔하게 중단됩니다.

가속기 장치 노드가 있는 호스트에서는 /etc/systemd/system/aigo-server.service.d/10-gpu.conf도 함께 씁니다. 유닛은 PrivateDevices=true로 서비스를 보호하는데, 이 설정은 /dev/nvidia*, /dev/kfd, /dev/dri가 없는 전용 /dev를 서비스에 제공합니다. 그래서 이 drop-in이 없으면 정상 동작하는 하드웨어에서도 서버가 "No GPU detected on this host"라고 보고합니다. CPU만 있는 호스트에는 drop-in을 설치하지 않고 더 엄격한 유닛을 그대로 둡니다. 무엇을 허용하는지, 나중에 GPU를 장착했을 때 직접 넣는 방법은 systemd 환경에서 GPU 접근을 참고하세요.

준비가 되면 직접 시작하세요.

sudo systemctl start aigo-server
sudo systemctl status aigo-server

이 모드가 아니면 설치 스크립트는 root 실행을 거부하며, 어떤 경우에도 sudo를 대신 호출하지 않습니다.

미러 및 폐쇄망 설치¶

AIGO_INSTALL_BASE_URL은 다운로드 원본을 교체합니다. 경로 형태는 공개 릴리스 URL과 같습니다(<base>/<tag>/<asset>).

curl -fsSL https://go.backend.ai/install.sh | \
  AIGO_INSTALL_BASE_URL=https://mirror.internal/aigo sh -s -- --version 1.11.1

미러에는 따라갈 "latest" 리다이렉트가 없으므로, 이 변수를 설정하면 --version이 필요합니다. 체크섬은 미러가 제공하는 SHA256SUMS.txt로 그대로 검증합니다. --system이 설치하는 systemd 파일도 마찬가지입니다. AIGO_INSTALL_SUPPORT_URL로 출처를 바꾸면 그 원본이 제공하는 자체 매니페스트로 체크섬을 검증합니다.

제거¶

curl -fsSL https://go.backend.ai/install.sh | sh -s -- --uninstall
curl -fsSL https://go.backend.ai/install.sh | sudo sh -s -- --system --uninstall

바이너리, 관리되는 PATH 블록, 생성된 env 파일을 제거하고, --system인 경우 systemd 유닛과 preset, logrotate 설정, GPU drop-in까지 제거합니다. /etc/aigo, /var/lib/aigo, /var/log/aigo는 그대로 두고, 제거 명령을 안내합니다.

지원 플랫폼¶

필요한 시스템 패키지¶

aigo-server는 릴리스 아카이브에 포함되지 않은 공유 라이브러리에 링크되어 있습니다. 데스크톱 배포판에는 대부분 이미 설치되어 있지만 최소 구성 컨테이너 이미지나 클라우드 서버 이미지, CI 러너에는 없는 경우가 많습니다. 서버를 실행하기 전에 먼저 설치하세요.

sudo apt-get install -y libdrm2 libdrm-amdgpu1 libssl3

sudo dnf install -y libdrm openssl-libs

바이너리가 실행되지 않을 때 설치 스크립트가 안내하는 패키지 목록과 같습니다.

OpenSSL 패키지는 어떤 버전에서든 설치해도 문제가 없으므로 위 명령을 그대로 실행하면 됩니다.

aigo CLI에는 해당하지 않습니다. C 런타임에만 링크되므로 CLI만 설치하는 경우 (--cli-only) glibc 2.39 외에 필요한 패키지가 없습니다.

iOS¶

Backend.AI GO는 iPhone 및 iPad용 App Store에서 사용할 수 있습니다.

1. iOS 기기에서 App Store를 엽니다.
2. "Backend.AI GO"를 검색합니다.
3. 받기를 탭하여 다운로드하고 설치합니다.
4. 앱을 실행하고 클라우드 프로바이더 API 키를 설정합니다.

지원되는 iOS 버전: iOS 18.0 이상

지원되는 기기: iOS 18.0 이상의 iPhone 및 iPad

권장 사양¶

데스크톱¶

iOS¶

도움이 필요하신가요? 문제 해결 페이지를 확인해 보세요.