Tomcat AWTError X11 headless

증상

Tomcat 기동 후 404. catalina.out에:

java.awt.AWTError: Can't connect to X11 window server using 'localhost:10.0'

Captcha 등 BufferedImage / AWT 사용 시 흔함 (헤드리스 서버).

해결 (JRE 1.4+)

catalina.sh 맨 위에 추가 후 재기동:

export JAVA_OPTS="$JAVA_OPTS -Djava.awt.headless=true"

CATALINA_OPTS 아래에만 넣으면 무시되는 경우가 있음 → 파일 상단 export 권장.

JRE 1.3 이하는 Xvfb 등 가상 디스플레이 필요.