TEGO ARM64 사용설명서

기존 기록입니다. 현재 원본의 SHA256은 에디션 페이지에서 확인하세요.

# TEGO ARM64 0.1 — Raspberry Pi 4

Raspberry Pi OS Lite (Debian 13 Trixie, 2026-09-15 ARM64)를 바탕으로 한 TEGO 클래식 데스크톱입니다. 권장 RAM **512MB를 목표**로 구성했습니다. 실물 Pi 및 512MB 제한 부팅 검증 전까지 이 수치는 확정된 성능 보장이 아닙니다.

## 구성

- IceWM 클래식 테마, 파일 관리자, 텍스트 편집기, 터미널
- NetSurf 경량 브라우저: 복잡한 JavaScript 웹 앱은 지원이 제한됩니다.
- NetworkManager의 텍스트형 Wi-Fi 설정
- 한글 글꼴, 필요할 때 메뉴에서 실행하는 IBus 한글 입력기
- RAM의 50% 크기인 zram 압축 스왑, 16MB 제한의 휘발성 로그
- 로그인 관리자 없이 첫 번째 콘솔 로그인 후 데스크톱 실행

기존 PC판의 Wine, Calamares 설치기, Falkon은 포함하지 않습니다. SD카드에 기록하는 IMG 배포판입니다.

## 빌드

Linux root 환경에서 qemu-user와 ARM64 binfmt, parted, e2fsprogs, dosfstools, xz-utils, curl이 필요합니다. 이미지 저장 공간을 최소 8GB 확보하세요. 빌드 장치의 RAM 권장량과 배포판의 512MB 목표는 별개입니다.

1. `cache/base.img.xz`와 `cache/base.sha256`에 아래 공식 이미지 및 체크섬을 저장합니다.
2. `sudo bash build.sh`를 실행합니다. 스크립트는 체크섬을 검증하고 일반 이미지 파일만 수정합니다.
3. `../dist/TEGO-ARM64/TEGO-ARM64-0.1-rpi4.img.xz`와 `SHA256SUMS`가 생성됩니다.

기반 이미지: https://downloads.raspberrypi.com/raspios_lite_arm64/images/raspios_lite_arm64-2026-09-15/2026-09-15-raspios-trixie-arm64-lite.img.xz

체크섬: 위 주소 뒤에 `.sha256` 추가.

## 설치 및 사용

1. Raspberry Pi Imager에서 사용자 지정 이미지로 `.img.xz`를 선택합니다.
2. 8GB 이상 microSD를 선택하여 기록합니다. 선택한 카드의 기존 내용은 지워집니다.
3. Pi 4에 HDMI 화면, 키보드, 마우스를 연결하고 전원을 넣습니다.
4. Raspberry Pi OS의 최초 계정 설정을 완료하고 로컬 콘솔에 로그인합니다. 기본 공유 비밀번호는 제공하지 않습니다.
5. IceWM 메뉴에서 Wi-Fi / 네트워크를 열어 연결합니다. 무선 국가 설정이 필요하면 터미널에서 `sudo raspi-config`를 사용합니다.
6. 한글 입력은 메뉴의 '한글 입력 켜기' 실행 후 IBus 설정에서 Korean–Hangul을 선택합니다.

## 512MB 검증 절차

실물 Pi 4에서 `/boot/firmware/config.txt`의 마지막 `[all]` 아래 `total_mem=512`를 추가하고 재부팅합니다. `free -m`, `swapon --show`, `systemctl --failed`를 확인하고 파일 관리자·편집기·가벼운 웹페이지를 사용해 응답성과 메모리 부족 여부를 검사합니다. 테스트 후 `total_mem=512`를 제거하면 장치의 전체 RAM을 사용할 수 있습니다. 출하 이미지에는 이 제한을 강제하지 않습니다.

공식 참고: https://www.raspberrypi.com/documentation/computers/os.html