Atuin: 29,794 GitHub Stars — 셸 히스토리 동기화 완벽 설정 가이드 2026

# Unix/macOS — 인터랙티브 설치, 셸 설정 프롬프트 포함
curl --proto '=https' --tlsv1.2 -LsSf https://setup.atuin.sh | sh

# 비인터랙티브 (CI, Dockerfile)
curl --proto '=https' --tlsv1.2 -LsSf https://setup.atuin.sh | sh -s -- --non-interactive

# Homebrew (macOS/Linux)
brew install atuin

# Cargo (Rust 툴체인 필요)
cargo install atuin

# Arch Linux
sudo pacman -S atuin

# NixOS / nix
nix-env -iA nixpkgs.atuin

# Debian/Ubuntu (GitHub releases에서)
VERSION="18.16.1"
curl -LO "https://github.com/atuinsh/atuin/releases/download/v${VERSION}/atuin_${VERSION}_amd64.deb"
sudo dpkg -i "atuin_${VERSION}_amd64.deb"

# Windows (WinGet)
winget install -e Atuinsh.Atuin

# Bash — ~/.bashrc에 추가
eval "$(atuin init bash)"

# Zsh — ~/.zshrc에 추가
eval "$(atuin init zsh)"

# Fish — ~/.config/fish/config.fish에 추가
atuin init fish | source

# Nushell — config.nu에 추가
atuin init nu | save ~/.config/nushell/atuin.nu
source ~/.config/nushell/atuin.nu

# 셸 자동 감지 및 가져오기
atuin import auto

# 또는 명시적으로 지정
atuin import bash
atuin import zsh
atuin import fish

# 가져온 개수 확인
atuin stats

$ atuin --version
atuin 18.16.1

$ atuin doctor
Atuin Doctor
Checking for diagnostics
[✓] Atuin is compiled with sqlite support
[✓] Atuin is compiled with sync support
[✓] Atuin config directory exists

# ~/.config/atuin/config.toml
[settings]
# 검색 모드: prefix, fulltext, fuzzy, skim
search_mode = "fuzzy"

# 필터 모드: global, host, session, directory
filter_mode = "global"

# UI 스타일: compact, full
style = "compact"

# 동기화 설정
auto_sync = true
sync_frequency = "5m"
sync_address = "https://api.atuin.sh"

# 민감한 명령어 기록 금지 (정규식 패턴)
history_filter = [
    "^export.*KEY",
    "^export.*SECRET",
    "^export.*PASSWORD",
    "^aws configure",
    "^ssh-keygen",
]

# 작업 디렉토리 필터 — 이 경로에서는 기록하지 않음
cwd_filter = [
    "/tmp/secrets",
    "~/.*cred",
]

# Enter로 명령어 실행; false = Tab으로 먼저 편집
enter_accept = true

# 검색 UI에서 도움말 표시
show_help = false

# 결과 수
inline_height = 20

# 현재 설정값 확인
atuin config get search_mode
# fuzzy

# 해석된 (유효) 값 확인
atuin config get search_mode --resolved
# fuzzy

# 인라인으로 설정값 변경
atuin config set search_mode fulltext
atuin config set filter_mode directory

# 전체 설정 출력
atuin config print

# Ctrl+R로 필터 모드 간 인터랙티브 전환
# 기본 필터 모드: global -> host -> session -> directory

# 필터가 적용된 명령줄 검색
atuin search --exit 0 --after "yesterday 3pm" make
atuin search --before "2026-01-01" --cwd /project deploy
atuin search --exit 1 --session       # 이 세션의 실패한 명령어

# 매칭 항목 삭제
atuin search --delete "rm -rf /accident"

# ~/.config/starship.toml — 특별한 설정 불필요
# Atuin이 히스토리 처리; Starship이 프롬프트 처리
# rc 파일에서 Atuin init이 Starship init보다 먼저 실행되도록 설정

# ~/.zshrc — 순서가 중요
eval "$(atuin init zsh)"       # Atuin 먼저
eval "$(starship init zsh)"    # Starship 다음

# ~/.tmux.conf — 키를 Atuin 검색 열기에 바인딩
bind-key r run-shell "tmux send-keys C-r"

# Atuin은 환경 변수를 통해 tmux 세션을 자동 감지
# 세션별 필터: Ctrl+R 누른 후 필터 모드 전환

# 파일은 fzf로, 히스토리는 Atuin으로
# fzf 히스토리 바인딩 비활성화 (~/.bashrc 또는 ~/.zshrc에서)
export FZF_DEFAULT_COMMAND='fd --type f --hidden'
# Ctrl+R 바인딩 금지 — Atuin이 처리하도록

# 파일 검색용 fzf
alias ff='fzf --preview "bat --style=numbers --color=always {}"'

# 히스토리용 Atuin (자동으로 Ctrl+R에 바인딩)

# Dockerfile.dev
RUN curl --proto '=https' --tlsv1.2 -LsSf https://setup.atuin.sh | sh -s -- --non-interactive
COPY config.toml /root/.config/atuin/config.toml
RUN echo 'eval "$(atuin init bash)"' >> /root/.bashrc

# docker-compose.yml
version: "3"
services:
  atuin:
    restart: always
    image: ghcr.io/atuinsh/atuin:latest
    command: server start
    volumes:
      - ./config:/config
      - ./atuin-data:/atuin-data
    links:
      - postgresql
    ports:
      - "8888:8888"
    environment:
      ATUIN_HOST: "0.0.0.0"
      ATUIN_PORT: "8888"
      ATUIN_OPEN_REGISTRATION: "true"
      ATUIN_DB_URI: "postgres://atuin:change-me@postgresql/atuin"
      RUST_LOG: "info,atuin_server=debug"
    user: "1000:1000"

  postgresql:
    image: postgres:14
    restart: always
    volumes:
      - ./postgres-data:/var/lib/postgresql/data
    environment:
      POSTGRES_USER: atuin
      POSTGRES_PASSWORD: change-me
      POSTGRES_DB: atuin
    user: "1000:1000"

  # 선택: 자동 백업
  backup:
    image: prodrigestivill/postgres-backup-local
    restart: always
    volumes:
      - ./backups:/backups
    links:
      - postgresql
    environment:
      POSTGRES_HOST: postgresql
      POSTGRES_DB: atuin
      POSTGRES_USER: atuin
      POSTGRES_PASSWORD: change-me
      POSTGRES_EXTRA_OPTS: "-Z6 --schema=public --blobs"
      SCHEDULE: "@daily"
      BACKUP_KEEP_DAYS: "7"

# 데이터 디렉토리 생성
mkdir -p atuin-data postgres-data backups

# 서비스 시작
docker compose up -d

# 상태 확인
curl http://localhost:8888/health
# {"status":"ok"}

# ~/.config/atuin/config.toml
[settings]
sync_address = "http://your-server:8888"
auto_sync = true
sync_frequency = "5m"

# 자체 호스팅 서버에 새 계정 등록
atuin register -u myuser -e myuser@example.com -p securepassword

# 또는 추가 머신에서 로그인
atuin login -u myuser -p securepassword

# 암호화 키 가져오기 (안전하게 백업)
atuin key
# c2e2d6e5a9b1c3f4d7e8a9b0c1d2e3f4...

# 동기화 트리거
atuin sync

# atuin-deployment.yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: atuin-server
spec:
  replicas: 2
  selector:
    matchLabels:
      app: atuin
  template:
    metadata:
      labels:
        app: atuin
    spec:
      containers:
        - name: atuin
          image: ghcr.io/atuinsh/atuin:18.16.1
          command: ["atuin", "server", "start"]
          ports:
            - containerPort: 8888
          env:
            - name: ATUIN_HOST
              value: "0.0.0.0"
            - name: ATUIN_DB_URI
              valueFrom:
                secretKeyRef:
                  name: atuin-db-secret
                  key: uri
---
apiVersion: v1
kind: Service
metadata:
  name: atuin-service
spec:
  selector:
    app: atuin
  ports:
    - port: 8888
      targetPort: 8888

$ atuin stats
[▮▮▮▮▮▮▮▮▮▮]  9,607 fg
[▮▮▮▮▮▮▮▮▮ ]  9,458 vim
[▮▮▮       ]  3,144 ag
[▮▮▮       ]  3,095 git status
[▮▮        ]  2,248 git diff
[▮         ]  1,787 curl
[▮         ]  1,571 jq
[▮         ]  1,357 rg
[▮         ]  1,348 cd
[▮         ]  1,322 git log
Total commands:   62,849
Unique commands:  26,908

# ~/.config/atuin/config.toml
[settings]
history_filter = [
    # AWS 자격 증명
    "^aws configure",
    "^export AWS_SECRET_ACCESS_KEY",
    # 일반 시크릿
    "^export.*SECRET",
    "^export.*PASSWORD",
    "^export.*TOKEN",
    "^echo.*password",
    # SSH 키
    "^ssh-add",
    "^ssh-keygen",
    # 데이터베이스 연결 문자열
    "^psql.*://.*:",
    "^mysql.*-p",
]

# SQLite 백업 (안전, 락 문제 없음)
sqlite3 ~/.local/share/atuin/history.db ".backup '/backup/atuin-$(date +%Y%m%d).db'"

# WAL 체크포인트로 복사
cp ~/.local/share/atuin/history.db ~/backups/atuin-backup.db

# cron을 통한 자동 일일 백업
0 2 * * * sqlite3 ~/.local/share/atuin/history.db ".backup '/backups/atuin/atuin-$(date +\%Y\%m\%d).db'" && find /backups/atuin -mtime +30 -delete

# 마지막 동기화 시간 확인
atuin sync --force  # 강제 동기화 및 상태 표시

# 동기화 정보 확인
atuin info
# Atuin v18.16.1
# Sync interval: 5m
# Sync address: https://api.atuin.sh
# Last sync: 2026-05-20T08:15:32Z
# History count: 47,231

# 문제 확인
atuin doctor

# ~/.config/atuin/config.toml
[theme]
# 터미널 기본 색상 사용
use_default_colors = true

# 또는 명시적 색상 지정
base = "#1e1e2e"
layer1 = "#313244"
text = "#cdd6f4"
accent = "#89b4fa"

# 이전 머신에서 — 클립보드에 키 복사 (또는 안전한 전송)
cat ~/.local/share/atuin/key

# 새 머신에서 — 설치 및 로그인 후
mkdir -p ~/.local/share/atuin
echo "YOUR_KEY_HERE" > ~/.local/share/atuin/key
chmod 600 ~/.local/share/atuin/key

# 동기화가 작동하는지 확인
atuin sync
atuin stats

# ~/.bashrc
export ATUIN_NOBIND=1
eval "$(atuin init bash)"
bind '"\C-r": "\C-aatuin search\C-j"'

# 검색 패턴으로 삭제
atuin search --delete "sensitive-command"

# 또는 TUI 사용 — 명령어를 찾은 후 Alt+Delete 누르기