무인 자동 설치 (Unattended Installs)

2026년 8월 13일2026년 8월 14일 수정됨

Omarchy 설치 ISO는 사람의 키보드 입력이 전혀 필요 없는 완전 자동 무인 설치를 공식 지원합니다. 설치 프로그램이 cidata 볼륨 라벨이 지정된 보조 드라이브에서 구성 파일을 감지하면, 대화형 설치 마법사를 완전히 건너뛰고 자동으로 설치를 완료한 후 재부팅합니다. 별도의 커스텀 ISO를 빌드할 필요가 없습니다.

이 기능을 활용하면 Proxmox나 Packer 환경에서 일회용 개발용 VM을 빠르게 배포할 수 있습니다. cidata는 cloud-init의 NoCloud 표준 규격을 따르므로 모든 가상화 플랫폼에서 손쉽게 마운트할 수 있습니다.

구성 파일 목록

이 파일들은 일반 설치 마법사가 생성하는 파일과 동일합니다:

파일명	필수 여부	역할 및 설명
`user_configuration.json`	예	디스크 파티션, 호스트명, 타임존, 키보드 배열
`user_credentials.json`	예	사용자명 및 비밀번호 해시값
`user_full_name.txt`	아니오	Git 커밋 사용자 이름
`user_email_address.txt`	아니오	Git 이메일 주소
`user_encrypt_installation.txt`	아니오	`disk_encryption` 블록 포함 시 `true`
`authorized_keys`	아니오	SSH 공개키 목록 (한 줄에 하나씩)
`tailscale_authkey`	아니오	첫 부팅 시 Tailscale 네트워크 자동 참여용 인증 키

비밀번호 해시는 openssl passwd -6 "yourpassword" 명령으로 생성합니다.

user_credentials.json 대신 defer-provisioning이라는 빈 파일을 넣으면 새 소유자 준비 모드로 설치됩니다.

SSH 접근 및 Tailscale 자동 구성

authorized_keys 파일이 있으면 사용자의 ~/.ssh/authorized_keys에 키를 등록하고 sshd 데몬을 활성화하며 방화벽 포트를 개방합니다.

tailscale_authkey 파일이 있으면 첫 부팅 시 Tailscale을 설치하고 네트워크에 자동으로 조인합니다.

cidata 드라이브 이미지 빌드

작은 ISO 이미지로 만드는 것이 가장 간단합니다:

mkdir cidata
cp user_configuration.json user_credentials.json authorized_keys cidata/
genisoimage -output cidata.iso -volid cidata -joliet -rock cidata/

Proxmox qm CLI 실행 예시:

qm create 101 --name my-omarchy \
  --bios ovmf --machine q35 --cpu host --cores 4 --memory 8192 \
  --ostype l26 --scsihw virtio-scsi-single \
  --efidisk0 local-lvm:0,efitype=4m,pre-enrolled-keys=0 \
  --scsi0 local-lvm:40,discard=on,iothread=1 \
  --net0 virtio,bridge=vmbr0 --vga virtio --serial0 socket \
  --ide2 local:iso/omarchy.iso,media=cdrom \
  --ide3 local:iso/cidata.iso,media=cdrom \
  --boot order='scsi0;ide2'

qm start 101

주의 사항

암호화된 무인 설치의 경우 첫 부팅 시 LUKS 비밀번호를 수동 입력해야 합니다. 또한 user_configuration.json에 비밀번호가 평문으로 포함되므로 cidata 이미지를 안전하게 관리하세요.

출처

Omarchy Manual: Unattended Installs공식