PlantUML 무료 다운로드·설치 방법, 텍스트로 시퀀스 다이어그램 만들기

회의에서 설명한 로그인 요청 흐름을 그림으로 남겨야 하는데, 도형을 옮길 때마다 선이 흐트러진다면 메시지 순서를 텍스트로 적어 보세요. PlantUML은 참여자와 화살표를 짧은 문장으로 쓰면 시퀀스 다이어그램을 그려 줍니다. 공식 사이트는 전체 기능을 사용할 수 있는 GPL판 JAR 파일을 무료로 제공합니다.

이 글은 PlantUML 1.2026.9 JAR를 기준으로 Java 환경을 확인하고, 요청과 응답 두 줄을 넣은 텍스트 파일에서 PNG를 만드는 순서까지 안내합니다. 프로그램 자체가 그림 편집기처럼 상자를 끌어 놓는 방식은 아닙니다. 처음에는 간단한 흐름으로 문법과 출력 파일 위치를 확인하는 편이 쉽습니다.

PlantUML

PlantUML 개발팀

Java 11 이상 권장지원 환경

무료다운로드 비용

1.2026.9공식 버전

텍스트로 시퀀스 다이어그램 작성주요 작업

PlantUML 1.2026.9 다운로드·설치 방법 보기

메시지 순서를 글로 적으면 다이어그램이 됩니다

시퀀스 다이어그램은 누가 누구에게 요청하고 무엇을 돌려주는지를 시간 흐름에 따라 보여 줍니다. PlantUML에서는 참여자 이름과 메시지를 텍스트 파일에 적습니다. 공식 설명의 가장 단순한 예처럼 Alice -> Bob: test 한 줄을 쓰면 두 참여자 사이에 실선 화살표가 그려집니다. 응답을 점선으로 나타내려면 Bob –> Alice: result처럼 화살표에 대시를 하나 더 넣습니다.

입력이 텍스트라서 순서가 바뀌면 줄의 위치를 바꾸고, 메시지가 추가되면 한 줄을 더 쓰면 됩니다. 도형의 간격과 선 배치는 렌더러가 정하므로 문서에 넣을 업무 흐름을 반복해서 수정하기 좋습니다. 공식 문서는 시퀀스 다이어그램뿐 아니라 클래스·활동·상태 다이어그램 등 여러 형식도 안내하지만, 각 형식의 문법은 서로 다릅니다. 처음 파일에는 시퀀스 구문만 사용하세요.

이 글에서 선택한 파일은 plantuml-1.2026.9.jar입니다. 공식 다운로드 페이지는 여러 라이선스의 JAR를 나란히 제공하며 GPL판을 전체 기능에 적합한 선택으로 설명합니다. 같은 버전의 소스 코드나 Java 8 호환판, 이름에 mit·lgpl이 붙은 JAR는 같은 파일이 아닙니다. 일반적인 로컬 사용을 시작한다면 공식 GPL판 파일 이름과 버전을 먼저 확인하세요.

PlantUML은 Java가 있어야 실행됩니다. 공식 시작 안내는 Java 11 이상을 권장하고, Java 8을 유지해야 하는 환경에는 별도 호환 빌드가 있다고 구분합니다. Windows용 실행 파일을 받는 절차와 달리 JAR는 별도 설치 마법사가 없습니다. Java가 준비된 폴더에서 명령으로 실행하거나 공식 GUI 모드를 열 수 있습니다. 조직 PC에서는 Java 설치와 파일 실행이 허용되는지도 확인해야 합니다.

공식 문서의 시퀀스 다이어그램 출력 예시

PlantUML 공식 문서에서 Participant와 Actor, Database, Queue를 보여 주는 시퀀스 다이어그램 출력

PlantUML 공식 시퀀스 문서의 출력 그림입니다. Participant에서 Actor·Database·Queue로 이어지는 메시지를 보여 주며, 프로그램 편집 창 화면은 아닙니다.

PlantUML 1.2026.9 다운로드·설치 방법 보기

프로그램	PlantUML
제공처	PlantUML 개발팀
대상 파일	plantuml-1.2026.9.jar
실행 조건	Java 11 이상 권장
버전	1.2026.9
라이선스	GPL판
다운로드 비용	무료
주요 용도	텍스트 기반 UML 다이어그램 생성

Java 확인부터 공식 JAR 선택까지

명령 프롬프트나 터미널에서 java -version을 입력해 Java가 설치됐는지 확인하세요. 버전 정보가 나오지 않으면 JAR를 받아도 바로 실행할 수 없습니다. 공식 시작 안내는 Java 11 이상을 권장합니다. Java 8만 쓸 수 있는 환경이라면 같은 페이지의 전용 호환 파일을 확인하고, 이 글의 1.2026.9 일반 JAR를 그 환경에 맞는다고 가정하지 마세요.

공식 다운로드 페이지에서 Latest Releases 아래 GPL의 Compiled jar를 찾으세요. 이 링크는 공식 GitHub 릴리스의 plantuml-1.2026.9.jar로 이어집니다. 다운로드 목록에서 파일 이름과 확장자가 .jar인지 확인하면 소스 코드 압축 파일이나 다른 라이선스 빌드와 구분됩니다. JAR를 찾기 쉬운 폴더에 두고 그 폴더에서 터미널을 여는 것이 첫 작업에 편합니다.

Windows에서는 별도 GraphViz 설치가 먼저 필요한지 걱정하기 쉽습니다. 공식 시작 안내는 Windows판에 컴파일된 GraphViz가 포함돼 있다고 설명합니다. 다만 일부 다이어그램은 GraphViz의 영향을 받고 운영체제·빌드별 조건이 다를 수 있으므로 출력 오류가 있을 때만 해당 형식의 요구 사항을 확인하세요. 처음 만드는 간단한 시퀀스 다이어그램을 위해 임의의 외부 설치 파일부터 받을 필요는 없습니다.

터미널에서 java -version으로 Java가 준비됐는지 확인합니다.
PlantUML 공식 다운로드 페이지의 GPL Compiled jar를 선택합니다.
plantuml-1.2026.9.jar 파일을 작업 폴더에 둡니다.

요청과 응답을 적고 PNG 만들기

메모장이나 텍스트 편집기에서 새 파일을 만들고 첫 줄에 @startuml, 마지막 줄에 @enduml을 적으세요. 사이에는 Alice -> Bob: 로그인 요청과 Bob –> Alice: 결과 반환을 각각 한 줄로 넣습니다. 파일 이름은 login-flow.puml처럼 저장하고 UTF-8로 보관하세요. 첫 화살표는 요청을, 점선 화살표는 응답을 구분할 때 쓰기 좋습니다. 한국어 메시지를 쓴다면 편집기와 터미널의 문자 인코딩도 함께 확인해야 합니다.

JAR와 puml 파일이 같은 폴더에 있다면 그 위치에서 java -jar plantuml-1.2026.9.jar login-flow.puml을 실행하세요. 공식 명령줄 안내는 입력 파일의 @startuml과 @enduml 블록을 찾아 PNG 파일을 만든다고 설명합니다. 실행 후 같은 위치에 login-flow.png가 생겼는지 확인하고 그림을 열어 요청과 응답의 방향이 맞는지 보세요. 파일 이름이나 경로가 다르면 명령의 해당 부분을 실제 저장 위치로 바꿔야 합니다.

PNG가 만들어졌어도 메시지 순서가 업무 흐름과 다를 수 있습니다. 텍스트 파일에서 줄의 순서를 바꾸거나 참여자를 명시하는 participant 이름 as 별칭 구문을 추가한 뒤 다시 생성하세요. 공식 문서는 actor, database, queue 같은 참여자 유형도 보여 줍니다. 처음부터 모든 기호를 넣기보다 요청자와 응답자 두 명으로 결과를 확인한 다음 필요한 시스템을 늘리는 편이 수정하기 쉽습니다.

보고서에 넣을 때는 생성된 PNG와 수정 가능한 puml 원본을 함께 보관하세요. PNG만 남기면 나중에 메시지 이름을 고칠 때 처음부터 다시 그려야 합니다. 반대로 puml의 문장을 바꾼 뒤 예전 PNG를 그대로 붙이면 문서와 원본이 어긋납니다. 최종 수정 후 같은 명령을 다시 실행하고 출력 그림의 화살표와 라벨을 확인하세요.

login-flow.puml에 @startuml, 요청·응답 두 줄, @enduml을 적습니다.
터미널에서 java -jar plantuml-1.2026.9.jar login-flow.puml을 실행합니다.
생성된 login-flow.png를 열어 참여자·메시지·방향을 확인합니다.

폴더를 보는 GUI 모드가 필요할 때

터미널 대신 생성 결과 목록을 보고 싶다면 java -jar plantuml-1.2026.9.jar -gui로 GUI 모드를 열 수 있습니다. 공식 GUI 안내에 따르면 이 창에서 소스 파일 폴더를 지정하면 해당 폴더의 문서를 주기적으로 확인하고 생성된 다이어그램 목록을 보여 줍니다. 목록의 그림을 더블클릭해 확인할 수 있습니다. GUI 자체가 도형을 드래그하는 편집기는 아니므로 puml 문장은 별도 텍스트 편집기에서 고칩니다.

파일을 저장했는데 GUI 목록에 안 보인다면 먼저 창 제목에 표시된 감시 폴더가 실제 저장 폴더와 같은지 보세요. 공식 안내의 Change directory로 경로를 바꿀 수 있습니다. 기본 감시 확장자에는 puml과 txt 등이 있지만, 다른 확장자로 저장했다면 확장자 입력란도 확인해야 합니다. 단일 파일을 확실히 시험할 때는 앞 절의 명령줄 방식이 경로 문제를 구분하기 좋습니다.

실행 오류와 비어 있는 출력 확인하기

'java'를 찾을 수 없다는 메시지가 나오면 PlantUML 파일 자체보다 Java 설치 또는 명령 경로가 먼저 문제입니다. java -version이 동작하는지 확인한 뒤 JAR 명령을 다시 시도하세요. Java 8만 설치된 PC에서는 일반판을 계속 재실행하지 말고 공식 다운로드 페이지가 따로 제공하는 Java 8 호환 빌드와 버전 조건을 확인해야 합니다.

JAR 파일을 찾지 못한다면 현재 터미널 폴더에서 파일 이름과 확장자를 확인하세요. 공식 릴리스 이름은 plantuml-1.2026.9.jar이므로 예시의 plantuml.jar와 다를 수 있습니다. 입력 파일을 못 찾는다면 login-flow.puml이 실제로 저장됐는지, Windows에서 .txt가 뒤에 붙어 있지 않은지 확인하세요. 파일 탐색기의 확장자 표시를 켜면 혼동을 줄일 수 있습니다.

PNG가 생성되지 않거나 오류 그림이 나온다면 @startuml·@enduml을 빠뜨리지 않았는지, 화살표 앞뒤 참여자 이름이 일치하는지 확인하세요. 먼저 공식 시작 안내의 Alice -> Bob: test 한 줄로 최소 예제를 만들면 파일 경로 문제와 문법 문제를 나눌 수 있습니다. 회사 문서의 민감한 메시지 내용을 입력했다면 온라인 서비스에 붙여 넣기보다 승인된 로컬 환경에서 JAR로 생성하세요.

자주 묻는 질문

PlantUML은 무료인가요?

네. 공식 다운로드 페이지에서 GPL판 JAR를 무료로 받을 수 있으며, 라이선스별로 제공 기능이 다를 수 있습니다.

Windows에서 별도 설치 프로그램이 필요한가요?

이 글의 대상은 Java JAR입니다. Java 11 이상을 준비한 뒤 JAR를 실행하며 별도 PlantUML 설치 마법사는 없습니다.

시퀀스 다이어그램을 PNG로 어떻게 저장하나요?

@startuml과 @enduml 사이에 메시지를 적은 puml 파일을 만든 뒤 java -jar plantuml-1.2026.9.jar 파일명.puml을 실행하세요.

GUI에서 상자를 끌어 그릴 수 있나요?

PlantUML은 텍스트 구문으로 그림을 만듭니다. GUI는 폴더와 생성 결과를 보는 용도이며 문장은 텍스트 편집기에서 고칩니다.

Java 8 PC에서도 같은 JAR를 쓰나요?

공식 사이트는 Java 11 이상을 권장하고 Java 8용 별도 호환 빌드를 구분합니다. 일반 JAR 대신 해당 파일과 조건을 확인하세요.

원본 문장과 생성 그림을 함께 확인하세요

Java 버전을 확인하고 PlantUML 1.2026.9 JAR를 받은 뒤, 요청·응답을 적은 puml 파일을 PNG로 생성해 보세요. 그림에서 방향과 순서가 맞는지 확인한 다음 원본 파일을 함께 보관하면 나중에 업무 흐름이 바뀌어도 문장만 고쳐 다시 만들 수 있습니다.