본문으로 건너뛰기

바이너리(Binary) 배포

Sinaptic® DROID+는 외부 종속성이 전혀 없는 정적으로 링크된 단일 바이너리 파일입니다. 파일을 다운로드하고 실행 권한을 부여한 뒤 바로 실행할 수 있습니다. 별도의 런타임, 패키지 매니저 또는 컨테이너가 필요하지 않습니다.

다운로드

설치 스크립트 (권장):

curl -fsSL https://get.droid.plus | sh

이 스크립트는 사용자의 운영체제(OS)와 아키텍처를 감지하여 올바른 바이너리를 다운로드하고 /usr/local/bin/ 위치에 저장합니다.

수동 다운로드:

GitHub Releases에서 플랫폼에 맞는 바이너리를 다운로드하세요.

플랫폼아키텍처바이너리 파일명
Linuxamd64droid-linux-amd64
Linuxarm64droid-linux-arm64
macOSApple Silicondroid-darwin-arm64
macOSInteldroid-darwin-amd64
Windowsamd64droid-windows-amd64.exe
chmod +x droid-linux-amd64
sudo mv droid-linux-amd64 /usr/local/bin/droid

실행 방법

# 프로젝트 초기화
droid init my-agent
cd my-agent

# API 키 설정
cp .env.example .env
# .env 파일을 열어 키를 입력하세요

# 시작
droid up

systemd 서비스로 실행

리눅스 운영 환경에서는 다음과 같이 systemd 유닛 파일을 생성하여 관리할 수 있습니다.

# /etc/systemd/system/droid.service
[Unit]
Description=DROID+ AI Agent Runtime
After=network.target

[Service]
Type=simple
User=droid
WorkingDirectory=/opt/droid
ExecStart=/usr/local/bin/droid up --config /opt/droid/droid.yaml
Restart=on-failure
RestartSec=5
EnvironmentFile=/opt/droid/.env

[Install]
WantedBy=multi-user.target
sudo systemctl daemon-reload
sudo systemctl enable --now droid

업데이트 방법

바이너리 파일을 교체하고 서비스를 재시작합니다.

curl -fsSL https://get.droid.plus | sh
sudo systemctl restart droid

설정 파일과 데이터 디렉토리는 바이너리와 별도로 분리되어 있으므로, 업데이트를 진행하더라도 기존 데이터는 안전하게 보존됩니다.