Activepieces 로컬 설치

모든 설치 과정은 Windows 기반이며, 본 문서는 공식문서에서 제공하는 Docker Compose를 이용한 로컬 실행법을 참고하여 작성되었습니다.

Docker Desktop & Git 설치

다음의 문서를 참조하세요.

• Docker Desktop 설치법
• Git 설치법

Activepieces 복제

Activepieces git clone 하기

• PowerShell 또는 명령 프롬프트(cmd)를 실행하고, 다음 명령어를 실행하여 Activepieces 소스 코드를 로컬 컴퓨터에 가져오기 Activepieces Github Repository

  git clone https://github.com/activepieces/activepieces.git

  

Ubuntu 설치하기(Optional)

Activepieces를 로컬에 설치 및 배포하기 위해, 반드시 Ubuntu를 설치해야 할 필요는 없습니다. (.env 파일을 직접 작성하는 방식으로 대체 가능) 하지만 공식 문서에서는 (수동으로 직접 입력하는 방식 대신) 쉘 스크립트(.sh) 파일을 실행하여 환경 변수를 생성하는 것을 권장하고 있습니다. 따라서 본 문서 또한 Ubuntu WSL을 이용하는 방식으로 진행합니다.

만약 .env 파일을 직접 생성하고 작성하고자 한다면, 다음 명령어를 실행하여 환경 설정 파일을 복사 및 생성합니다.

  cp .env.example .env

그다음에 .env 파일 내에 비어 있는 값들을 직접 작성해주면 됩니다. 비어 있는 값으로는 AP_API_KEY, AP_ENCRYPTION_KEY, AP_JWT_SECRET, AP_POSTGRES_PASSWORD이 있습니다. 값이 하나라도 비어 있다면 Activepieces의 Docker 컨테이너가 실행되지 않습니다!

AP_POSTGRES_PASSWORD을 입력하지 않았을 경우 발생하는 에러

Ubuntu 란

데비안(Debian) 계열의 가장 대중적인 리눅스 배포판 중 하나입니다. Ubuntu는 **WSL(WIndows Subsystem for Linux)**를 통해 Windows에서도 리눅스 개발환경을 자연스럽게 구축할 수 있게 도와줍니다. Windows 환경에서 bash, apt, grep, sed, ssh 등과 같은 Linux 명령어를 사용하기 위해서는 반드시 Ubuntu와 같은 WSL을 설치해야만 합니다.

• Microsoft Store에서 Ubuntu를 검색하여 원하는 Ubuntu 버전을 설치합니다. (이 방식이 쉽고 빠름!)

• 설치가 완료되면 [열기] 버튼을 클릭하고, unix username과 password를 입력하고, Ubuntu를 종료합니다.

• PowerShell 또는 명령 프롬프트(cmd) 창에서 다음의 명령어를 실행하여 Ubuntu를 WSL 기본값으로 설정합니다.

  
  
  1. 자신의 컴퓨터에 설치된 WSL 리스트 및 Ubuntu 버전 확인.

     wsl -l -v

     
  2. Ubuntu를 WSL 기본값으로 설정

     wsl --set-default ${Ubuntu-version}
     wsl -l

     

Activepieces 컨테이너 시작

환경 변수 생성하기

• PowerShell 또는 명령 프롬프트(cmd)에서 다음 명령어를 실행하여 WSL 환경에 진입.

wsl

• Activepieces 소스 코드의 디렉토리로 이동.

  cd activepieces

• 다음 명령어를 실행하여 쉘 스크립트 파일(.sh)을 변환.

  sudo apt install dos2unix
  dos2unix tools/deploy.sh

왜 쉘 스크립트 파일을 변환하는가?

Windows 환경에서 쉘 스크립트 파일을 변환하지 않고,

sh tools/deploy.sh

위의 명령어를 바로 실행할 경우, 매우 높은 확률로 다음과 같은 오류가 발생합니다.

: not foundy.sh: 2:  
: not foundy.sh: 4: 
tools/deploy.sh: 15: Syntax error: "fi" unexpected (expecting "then")

이 오류는 스크립트 내용이 잘못된 것이 아닌, Windows에서 줄바꿈 형식(CRLF) 때문에 발생하는 100% 전형적인 문제입니다. 다시 말해 Windows에서 파일을 다운받으면 CRLF 포맷으로 저장되는데, Linux 쉘은 CRLF를 읽지 못해서 이런 오류 발생하는 것입니다.

dos2unix tools/deploy.sh 명령어는 파일의 줄바꿈 형식을 Windows 스타일(CRLF) → Linux 스타일(LF)로 바꿔주는 명령어입니다.

• 다음 명령어를 실행하여 환경 변수 생성 → .env파일 생성됨.

  sh tools/deploy.sh

Activepieces 실행하기

docker compose -p activepieces up

Activepieces 컨테이너가 생성된 후, 웹 브라우저에 localhost:8080 를 입력하고 시작!

---

Activepieces 업데이트

방법1: Automatic Pull

• 업데이트 스크립트 실행 (deploy.sh와 동일하게 dos2unix로 변환해주기)

sh tools/update.sh
docker compose up -d --remove-orphans

방법2: Manually Pull

git pull
docker compose pull
docker compose up -d --remove-orphans