설치 가이드 · 7 min read · Oct 31, 2025

Ubuntu 22.04에 OpenProject 설치하기

OpenProject는 오픈 소스이며 웹 기반의 프로젝트 관리 시스템입니다. 팀이 연결하고 작업을 구조화하며 결과를 달성할 수 있는 안전하고 안전한 방법을 제공합니다. OpenProject를 사용하면 한 곳에서 자신의 작업을 조직하고 팀원에게 작업을 할당할 수 있습니다. 커뮤니티 에디션은 다양한 기능과 플러그인을 포함하고 있으며 무료로 제공됩니다. 프로젝트 계획 및 일정 관리, 위키, 포럼, 애자일 및 스크럼, 버그 추적 등 다양한 기능을 제공합니다.

이 게시물에서는 Ubuntu 22.04에서 Docker를 사용하여 OpenProject를 설치하는 방법을 설명합니다.

전제 조건

  • Ubuntu 22.04를 실행하는 서버.
  • 서버에 루트 비밀번호가 설정되어 있어야 합니다.

시작하기

먼저 시스템 패키지를 최신 버전으로 업데이트하고 업그레이드해야 합니다. 다음 명령어로 수행할 수 있습니다:

apt update -y  
apt upgrade -y

모든 패키지가 업데이트되면 다음 단계로 진행할 수 있습니다.

Docker 설치

다음으로 서버에 Docker 엔진을 설치해야 합니다. 다음 명령어를 실행하여 설치할 수 있습니다:

apt install docker.io -y

Docker가 설치되면 다음 명령어를 사용하여 Docker 버전을 확인할 수 있습니다:

docker --version

다음 출력에서 Docker 버전을 확인할 수 있어야 합니다:

Docker version 20.10.12, build 20.10.12-0ubuntu4

다음 명령어로 Docker 상태를 확인할 수도 있습니다:

systemctl status docker

다음과 같은 출력을 받을 수 있습니다:

? docker.service - Docker Application Container Engine
     Loaded: loaded (/lib/systemd/system/docker.service; enabled; vendor preset: enabled)
     Active: active (running) since Mon 2022-09-12 03:55:27 UTC; 27min ago
TriggeredBy: ? docker.socket
       Docs: https://docs.docker.com
   Main PID: 2188 (dockerd)
      Tasks: 18
     Memory: 175.3M
        CPU: 2min 52.389s
     CGroup: /system.slice/docker.service
             ??2188 /usr/bin/dockerd -H fd:// --containerd=/run/containerd/containerd.sock

Sep 12 04:05:02 ubuntu2204 dockerd[2188]: time="2022-09-12T04:05:02.260137217Z" level=info msg="Container failed to exit within 10s of signal>
Sep 12 04:05:02 ubuntu2204 dockerd[2188]: time="2022-09-12T04:05:02.288143240Z" level=info msg="ignoring event" container=c69a4c77c21fcc30bf5>
Sep 12 04:05:02 ubuntu2204 dockerd[2188]: time="2022-09-12T04:05:02.313368392Z" level=info msg="ignoring event" container=1e168552ee6decb4d38>
Sep 12 04:05:02 ubuntu2204 dockerd[2188]: time="2022-09-12T04:05:02.346672185Z" level=info msg="ignoring event" container=4f042da15c0abe50ac0>
Sep 12 04:05:03 ubuntu2204 dockerd[2188]: time="2022-09-12T04:05:03.128611054Z" level=info msg="ignoring event" container=d07c7ddcf4c5c8e1df3>
Sep 12 04:05:03 ubuntu2204 dockerd[2188]: time="2022-09-12T04:05:03.471773239Z" level=info msg="ignoring event" container=f0095298f0394b4e97c>
Sep 12 04:05:03 ubuntu2204 dockerd[2188]: time="2022-09-12T04:05:03.860303969Z" level=info msg="ignoring event" container=7c591187d6dea45ad9c>
Sep 12 04:10:05 ubuntu2204 dockerd[2188]: time="2022-09-12T04:10:05.733958315Z" level=info msg="ignoring event" container=a9126dced469461963a>
Sep 12 04:17:00 ubuntu2204 dockerd[2188]: time="2022-09-12T04:17:00.365019409Z" level=info msg="ignoring event" container=317a71b1e5e2810e618>
Sep 12 04:19:40 ubuntu2204 dockerd[2188]: time="2022-09-12T04:19:40.133136639Z" level=info msg="ignoring event" container=e5fa71f4c2a7d8f3dc4>

OpenProject 컨테이너 다운로드 및 실행

OpenProject를 설치하는 가장 간단하고 쉬운 방법은 Docker 컨테이너로 실행하는 것입니다. 다음 명령어를 실행하여 다운로드하고 실행할 수 있습니다:

docker run -dit -p 8080:80 -e OPENPROJECT_SECRET_KEY_BASE=secret -e OPENPROJECT_HOST__NAME=127.0.0.1:8080 -e OPENPROJECT_HTTPS=false openproject/community:12

이 명령어는 OpenProject 커뮤니티 Docker 이미지를 다운로드하고 아래와 같이 시작합니다:

Unable to find image 'openproject/community:12' locally
12: Pulling from openproject/community
76dff75df4d9: Pull complete 
3e8c90a1c4bb: Pull complete 
b3662c105080: Pull complete 
ad5dcb7dd592: Pull complete 
fa57cc7ce341: Pull complete 
9b3a1f58f992: Pull complete 
3ba44da7772d: Pull complete 
bb99cfe1d593: Pull complete 
d9be85920c31: Pull complete 
887163836f1b: Pull complete 
8d9b5634408e: Pull complete 
40cd37c7c054: Pull complete 
8f3f7ae1eab6: Pull complete 
0bad647edadc: Pull complete 
7604d9da2c69: Pull complete 
5064bcba96f5: Pull complete 
a31fefd0310b: Pull complete 
57856090623a: Pull complete 
c5788f49d4cb: Pull complete 
Digest: sha256:5b3850c813b44e0e83b31ee3ee7e65a22a05009f5101132caee51b4c799adaa9
Status: Downloaded newer image for openproject/community:12
cecc63dbe7c8263cdf9813a5dee5d5cfda3e2f8b8cdb78b3d038679507fa7769

다음 명령어로 다운로드한 Docker 이미지를 확인할 수 있습니다:

docker images

다음과 같은 출력을 받을 수 있습니다:

REPOSITORY              TAG       IMAGE ID       CREATED       SIZE
openproject/community   12        88f613862e98   11 days ago   1.93GB

OpenProject 컨테이너 상태를 확인하려면 다음 명령어를 실행하세요:

docker ps

OpenProject 컨테이너가 시작되고 포트 8080에서 수신 대기 중인 것을 확인할 수 있어야 합니다:

CONTAINER ID   IMAGE                      COMMAND                  CREATED          STATUS          PORTS                                             NAMES
cecc63dbe7c8   openproject/community:12   "./docker/prod/entry…"   12 seconds ago   Up 11 seconds   5432/tcp, 0.0.0.0:8080->80/tcp, :::8080->80/tcp   silly_fermi

다음 명령어로 OpenProject 컨테이너 로그를 확인할 수도 있습니다:

docker logs cecc63dbe7c8

다음과 같은 출력을 받을 수 있습니다:

=> Booting Puma
=> Rails 7.0.3.1 application starting in production 
=> Run `bin/rails server --help` for more startup options
I, [2022-09-12T04:25:12.466164 #138]  INFO -- : Using schema cache file /app/db/schema_cache.yml
[138] Puma starting in cluster mode...
[138] * Puma version: 5.6.4 (ruby 3.1.2-p20) ("Birdie's Version")
[138] *  Min threads: 4
[138] *  Max threads: 16
[138] *  Environment: production
[138] *   Master PID: 138
[138] *      Workers: 2
[138] *     Restarts: (?) hot (?) phased
[138] * Preloading application
[138] * Listening on http://0.0.0.0:8080
[138] Use Ctrl-C to stop
[138] - Worker 1 (PID: 337) booted in 0.01s, phase: 0
[138] - Worker 0 (PID: 336) booted in 0.02s, phase: 0

OpenProject를 위한 Apache를 리버스 프록시로 구성하기

보시다시피 OpenProject는 포트 8080에서 수신 대기 중입니다. 따라서 포트 80을 통해 OpenProject에 접근하기 위해 Apache를 리버스 프록시로 구성하는 것이 좋습니다.

먼저 다음 명령어를 사용하여 Apache 웹 서버 패키지를 설치합니다:

apt install apache2 -y

Apache가 설치되면 다음 명령어로 필요한 모듈을 활성화합니다:

a2enmod proxy_http headers rewrite

다음으로 다음 명령어로 Apache 가상 호스트 구성 파일을 생성합니다:

nano /etc/apache2/sites-available/openproject.conf

다음 구성을 추가합니다:


ServerName openproject.linuxbuz.com

RewriteEngine on
RewriteRule "^$" "/" [R,L]

ProxyRequests off


ProxyPreserveHost On
ProxyPass http://127.0.0.1:8080/
ProxyPassReverse http://127.0.0.1:8080/

파일을 저장하고 닫은 후 다음 명령어로 OpenProject 가상 호스트를 활성화합니다:

a2ensite openproject.conf

마지막으로 다음 명령어로 Apache 서비스를 재시작하여 변경 사항을 적용합니다:

systemctl reload apache2

다음 명령어로 Apache 상태를 확인할 수도 있습니다:

systemctl status apache2

다음과 같은 출력을 받을 수 있습니다:

? apache2.service - The Apache HTTP Server
     Loaded: loaded (/lib/systemd/system/apache2.service; enabled; vendor preset: enabled)
     Active: active (running) since Mon 2022-09-12 04:26:23 UTC; 1min 30s ago
       Docs: https://httpd.apache.org/docs/2.4/
    Process: 14508 ExecReload=/usr/sbin/apachectl graceful (code=exited, status=0/SUCCESS)
   Main PID: 14058 (apache2)
      Tasks: 55 (limit: 4579)
     Memory: 5.4M
        CPU: 98ms
     CGroup: /system.slice/apache2.service
             ??14058 /usr/sbin/apache2 -k start
             ??14512 /usr/sbin/apache2 -k start
             ??14513 /usr/sbin/apache2 -k start

Sep 12 04:26:23 ubuntu2204 systemd[1]: Starting The Apache HTTP Server...

Let’s Encrypt SSL로 OpenProject 보안 설정하기

OpenProject 웹사이트에서 SSL을 활성화하는 것이 좋습니다. 먼저 다음 명령어로 Certbot 클라이언트 패키지를 설치합니다:

apt install python3-certbot-apache -y

다음으로 다음 명령어를 실행하여 웹사이트 도메인에 대한 Let’s Encrypt SSL을 다운로드하고 설치합니다.

certbot --apache -d openproject.linuxbuz.com

다음과 같이 모든 질문에 답하여 Let’s Encrypt SSL을 설치합니다:

Saving debug log to /var/log/letsencrypt/letsencrypt.log
Enter email address (used for urgent renewal and security notices)
 (Enter 'c' to cancel): [email protected]


- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Please read the Terms of Service at
https://letsencrypt.org/documents/LE-SA-v1.2-November-15-2017-w-v1.3-notice.pdf.
You must agree in order to register with the ACME server. Do you agree?
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
(Y)es/(N)o: (Y)es/(N)o: Y

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Would you be willing, once your first certificate is successfully issued, to
share your email address with the Electronic Frontier Foundation, a founding
partner of the Let's Encrypt project and the non-profit organization that
develops Certbot? We'd like to send you email about our work encrypting the web,
EFF news, campaigns, and ways to support digital freedom.
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
(Y)es/(N)o: Y
Account registered.
Requesting a certificate for openproject.linuxbuz.com

Successfully received certificate.
Certificate is saved at: /etc/letsencrypt/live/openproject.linuxbuz.com/fullchain.pem
Key is saved at:         /etc/letsencrypt/live/openproject.linuxbuz.com/privkey.pem
This certificate expires on 2022-12-11.
These files will be updated when the certificate renews.
Certbot has set up a scheduled task to automatically renew this certificate in the background.

Deploying certificate
Successfully deployed certificate for openproject.linuxbuz.com to /etc/apache2/sites-available/openproject-le-ssl.conf
Added an HTTP->HTTPS rewrite in addition to other RewriteRules; you may wish to check for overall consistency.
Congratulations! You have successfully enabled HTTPS on https://openproject.linuxbuz.com
We were unable to subscribe you the EFF mailing list because your e-mail address appears to be invalid. You can try again later by visiting https://act.eff.org.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
If you like Certbot, please consider supporting our work by:
 * Donating to ISRG / Let's Encrypt:   https://letsencrypt.org/donate
 * Donating to EFF:                    https://eff.org/donate-le
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

OpenProject 웹 UI 접근하기

이제 웹 브라우저를 열고 URL https://openproject.linuxbuz.com를 사용하여 OpenProject에 접근합니다. OpenProject 환영 페이지가 표시되어야 합니다:

로그인 버튼을 클릭합니다. OpenProject 로그인 페이지가 표시되어야 합니다:

기본 사용자 이름과 비밀번호를 admin / admin으로 입력한 후 로그인 버튼을 클릭합니다. 비밀번호 변경 화면이 표시되어야 합니다:

기본 비밀번호를 변경하고 저장 버튼을 클릭합니다. 다음 화면에서 OpenProject 대시보드를 볼 수 있어야 합니다:

결론

축하합니다! Ubuntu 22.04에 Docker를 사용하여 OpenProject를 성공적으로 설치했습니다. 이제 조직에서 OpenProject를 구현하고 중앙 위치에서 프로젝트를 관리하고 추적할 수 있습니다.

Share: X/Twitter LinkedIn
#설치 가이드

새 게시물을 받은 편지함에서 받기

스팸은 없습니다. 언제든지 구독 해지 가능합니다.