말로 시키면 SNS에 올려주는 AI 비서, Postiz 내 컴퓨터에 설치하기 + 설정 파일

말로 시키면 SNS에 올려주는 AI 비서, Postiz 내 컴퓨터에 설치하기

바로 받는 설정 파일

① Docker Desktop 설치하고 켜기

docker.com 에서 Docker Desktop 을 받아 설치하고 한 번 켭니다(고래 아이콘이 메뉴바에 뜨면 됨). 이게 Postiz가 돌아가는 상자입니다.

② 설정 파일 받아서 한 줄 실행

위 zip 을 풀면 파일 두 개가 나옵니다. 폴더 하나에 그대로 둡니다.

• docker-compose.yaml
• dynamicconfig/ 폴더

파일 안의 JWT_SECRET: '여기에-아무-글자나-길게-입력' 을 아무 글자나 길게 바꿉니다. 그다음 터미널에서 그 폴더로 들어가 한 줄:

docker compose up -d

처음엔 프로그램을 내려받느라 5~15분 걸립니다. 끝나면 브라우저에서 http://localhost:4007 을 엽니다.

③ 가입 (내 컴퓨터 안에서만 쓰는 계정)

이메일·비밀번호·회사 이름을 적고 Create Account. 이 계정은 내 컴퓨터 안에만 있습니다. 밖으로 안 나갑니다.

④ 채널 연결 화면

가입하면 바로 이 화면입니다. X, 인스타, 스레드, 유튜브, 틱톡, 핀터레스… 한 번에 보입니다.

단, 스레드·인스타·유튜브는 메타·구글 개발자 앱의 ID와 비밀키를 ②의 파일에 먼저 넣어야 연결됩니다. 안 넣고 누르면 이렇게 오류가 납니다.

파일에서 THREADS_APP_ID: '' THREADS_APP_SECRET: '' 칸에 메타 앱의 값을 넣고 docker compose down → docker compose up -d 로 다시 켜면 됩니다. 메타 앱 만드는 법은 바코드랩 "스레드 수익화" 자료에 있습니다.

지금은 Continue without channels 로 넘어가도 됩니다.

⑤ AI 비서 연결 화면 — 여기가 핵심

클로드, 챗GPT, 클로드 코드, 커서 중 고릅니다. 클로드면 Add to Claude 버튼 하나, 또는 클로드 설정 → Connectors → 커스텀 커넥터에 http://localhost:4007/api/mcp-oauth-dynamic 을 붙여넣으면 끝입니다.

터미널파는 세 줄:

npm install -g postiz
postiz auth:login
npx skills add gitroomhq/postiz-agent

⑥ 달력에 예약이 쌓이는 곳

주간 달력입니다. 칸을 누르면 글을 쓰고 예약할 수 있고, AI 비서가 잡아 준 예약도 여기 나타납니다.

⑦ 내장 AI 비서에게 바로 시키기

왼쪽 메뉴 Agent. "다음 주 월요일 아침 8시에 이 사진 인스타랑 스레드에 올려줘" 처럼 적으면 글을 만들고 예약까지 합니다. (이 기능은 ②의 파일에 OPENAI_API_KEY 를 넣어야 동작합니다.)

꼭 지킬 것

• 예약은 Postiz가 하지만 올라가는 건 각 플랫폼의 공식 API 입니다. 하루 몇 개 같은 플랫폼 한도는 그대로 적용됩니다.
• 비밀키(JWT_SECRET, 앱 시크릿, OPENAI 키)는 파일에만 넣고 어디에도 붙여넣지 마세요.
• 내 컴퓨터가 꺼져 있으면 예약도 안 올라갑니다. 24시간 돌리려면 서버(월 몇 천 원)에 올려야 합니다.

막히면

• docker compose up -d 가 안 됨 → Docker Desktop 이 켜져 있는지. 고래 아이콘 확인.
• localhost:4007 이 안 열림 → 처음 받는 중. 10분 뒤 다시. docker ps 로 postiz 가 healthy 인지.
• 채널 누르면 오류 → ④. 앱 ID·시크릿을 안 넣은 것.
• 끄기 → 그 폴더에서 docker compose down. 데이터는 남습니다.

출처: github.com/gitroomhq/postiz-app (AGPL, 스타 40.9k 2026-11-05) · 공식 compose 저장소 gitroomhq/postiz-docker-compose · 화면 캡처 2026-11-05 로컬 설치

🙋 이번 주 미션: 도커 설치하고 ③ 가입 화면까지 가서 캡처를 카톡방에 올려 보기!