メインコンテンツへスキップ

LinuxサーバーにGitLabをセットアップ - 自分だけのDevOpsプラットフォームをホストしよう

このガイドに最適な製品

今すぐ始めましょう — 最適な製品を注文して、このガイドに沿ってステップバイステップで進めてください。

VPSから 7.90€
専用サーバーから 58.90€

はじめに​

GitLabは、チームがコードでコラボし、ワークフローを自動化し、ソフトウェア開発ライフサイクル全体を効率的に管理できる包括的なDevOpsプラットフォームです。このガイドでは、LinuxサーバーにGitLabをインストールする方法を解説します。

One Click AppsインストーラーでGitLabをインストール​

VPSのウェブインターフェースにあるOne Click Appsインストーラーから直接GitLabをインストールできます。初期アプリ設定が完了したら、アプリカタログを開き、GitLabを検索して、プロジェクト、環境、ドメイン設定を選択してデプロイを開始しましょう。これにより、コマンドラインでの手動セットアップなしで、統合されたウェブベースの管理、カスタムドメイン対応、利用可能な場合はSSL証明書の発行などのメリットを享受しつつ、素早く簡単にGitLabを展開・管理できます。

準備​

以下の要件は公式のGitLabチームによって推奨されており、後々のトラブルを避けるために必ず事前に確認しておくことをおすすめします。

ハードウェア​

コンポーネント最低要件推奨要件
CPU2x 2 GHz4x 2.6+ GHz
RAM4 GB8 GB
ストレージ10 GB50 GB以上
帯域幅100 Mbit/s (上り下り)100 Mbit/s (上り下り)

ソフトウェア​

プラットフォームオプション
OSUbuntu (20.04, 22.04, 24.04), Debian(10, 11, 12), OpenSUSE (15.5)
データベースPostgreSQL 14.9+
ウェブサーバーNGINX (GitLabに同梱), Puma 6.4.2+
その他Redis 7.x+, Sidekiq 7.3.2+, Prometheus 2.54.1+
備考

最新かつ正確な仕様情報は、GitLab公式のハードウェア要件ドキュメントを必ずご確認ください。

GitLabをLinuxサーバーにインストールするには、SSHクライアントで接続する必要があります。詳しくは初期アクセス（SSH）ガイドをご覧ください。

接続が確立したら、GitLabのインストールに必要なパッケージのインストールを始めましょう。

ステップ1：依存関係のインストール​

まず、GitLabインストーラーを動かすために必要な依存関係をインストールします。以下のコマンドでLinuxサーバーに必要なパッケージをインストールしてください。

パッケージリストを最新に更新し、OpenSSHサーバーと必要な前提パッケージをインストールします。これがGitLabのウェブインターフェースをホストする基盤となります。

sudo apt update
sudo apt-get install -y curl openssh-server ca-certificates tzdata perl

メール通知機能を使いたい場合は、Postfix（SMTPサーバー）もインストール可能です。これは任意です。

メール通知を使う場合は、以下のコマンドでPostfixをインストールしてください。

sudo apt-get install -y postfix
備考

Postfixのインストール中に設定画面が表示された場合は、「Internet Site」を選択してEnterを押してください。メール名にはLinuxサーバーの外部DNS名を入力しEnterを押します。追加の画面が出た場合は、すべてデフォルト設定でEnterを押して進めてください。

別のメール送信ソリューションを使いたい場合はこのステップをスキップし、GitLabインストール後に公式GitLabチームのガイドに従って外部SMTPサーバーを設定してください。

ステップ2：GitLabのインストール​

必要な依存関係のインストールが完了したら、いよいよGitLabをインストールします。

このガイドでは、公式パッケージリポジトリから直接GitLabをインストールします。

以下のスクリプトでGitLabのリポジトリをaptパッケージマネージャーに追加します。

curl https://packages.gitlab.com/install/repositories/gitlab/gitlab-ee/script.deb.sh | sudo bash

完了したら、gitlab-eeパッケージをインストールします。

sudo apt-get install -y gitlab-ee

インストールが完了すると、LinuxサーバーにGitLabが準備されます。次のセクションで、サーバーを正常に動作させるための基本設定を行いましょう。

ステップ3：GitLabの設定​

正常に動作させるために、設定ファイルの一部を編集します。まずはお好みのテキストエディタでGitLabの設定ファイルを開きます。ここでは例としてnanoを使います。

sudo nano /etc/gitlab/gitlab.rb

次に、external_urlの行を探し、ドメインをお持ちの場合はドメイン名を、ない場合はLinuxサーバーのIPアドレスを入力してください。

## GitLab URL
##! GitLabにアクセスするためのURL。
##! external_urlの設定詳細は以下を参照：
##! https://docs.gitlab.com/omnibus/settings/configuration.html#configuring-the-external-url-for-gitlab
##!
##! 注意：インストールやアップグレード時に環境変数
##! EXTERNAL_URLの値がここに反映されます。
##! AWS EC2インスタンスの場合は、AWSからパブリックホスト名/IPアドレスを取得します。
##! 詳細は以下を参照：
##! https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instancedata-data-retrieval.html
external_url 'http`s`://`あなたのドメインまたはLinuxサーバーのIPv4アドレス`'

さらに、letsencrypt['contact_emails']の行にメールアドレスを入力することをおすすめします。これによりLet's Encryptから自動で無料SSL証明書の通知や連絡が届きます。

注記

無料のSSL証明書をLet's Encryptから取得するにはドメインが必要です。IPアドレスでは直接取得できません。

################################################################################
# Let's Encrypt連携設定
################################################################################
# letsencrypt['enable'] = nil
# letsencrypt['contact_emails'] = [`あなたのメールアドレス`] # 連絡先メールアドレスの配列
# letsencrypt['group'] = 'root'
# letsencrypt['key_size'] = 2048
# letsencrypt['owner'] = 'root'
# letsencrypt['wwwroot'] = '/var/opt/gitlab/nginx/www'
# 設定詳細は以下を参照：
# https://docs.gitlab.com/omnibus/settings/ssl/index.html#renew-the-certificates-automatically
# letsencrypt['auto_renew'] = true
# letsencrypt['auto_renew_hour'] = 0
# letsencrypt['auto_renew_minute'] = nil # 数字またはcron式
# letsencrypt['auto_renew_day_of_month'] = "*/4"
# letsencrypt['auto_renew_log_directory'] = '/var/log/gitlab/lets-encrypt'
# letsencrypt['alt_names'] = []
ヒント

CTRL+Wでletsencrypt['contact_emails']を検索するとファイル内を簡単に探せます。

編集が終わったら、CTRL+X、Y、Enterの順に押して変更を保存して終了します。

最後に、以下のコマンドでGitLabを新しい設定で再構成します。

sudo gitlab-ctl reconfigure

この処理は少し時間がかかります。設定情報を元にGitLabを初期化し、ドメインを使っていればSSL証明書も自動発行されます。

ステップ4：ウェブインターフェースにアクセス​

初期化が完了したら、ブラウザからサーバーにアクセスできます。以下のようにドメイン名またはIPアドレスを入力してください。

https://[あなたのドメイン] または http://[あなたのIPアドレス]

初回アクセス時はログイン画面が表示されます。

管理者アクセスを得るには、ユーザー名にrootを使ってログインしてください。

パスワードはLinuxサーバー内のファイルに保存されています。以下のコマンドでファイルを開き、Password欄の値を確認してください。

sudo nano /etc/gitlab/initial_root_password
# 警告：この値は以下の条件でのみ有効です

# 1. 手動で設定されている場合（`GITLAB_ROOT_PASSWORD`環境変数や`gitlab_rails['initial_root_password']`設定）

# 2. パスワードがUIやコマンドラインで変更されていない場合

#

# もしここにあるパスワードでログインできない場合は、以下を参照して管理者パスワードをリセットしてください。
# https://docs.gitlab.com/ee/security/reset_user_password.html#reset-your-root-password

Password: `[ここにパスワードが表示されます]`

# 注意：このファイルは初回の再構成実行後24時間以内に自動削除されます。

ログイン画面でユーザー名とパスワードを入力すると、GitLabのダッシュボードに入れます。これで自分だけのLinuxサーバー上にGitLabパネルが立ち上がりました。

rootユーザーのパスワード変更や新規ユーザー作成は、左下のAdminからOverview->Usersで行えます。ここでGitLabインスタンスのユーザー管理が可能です。

オプション：ufwでファイアウォールを設定​

ファイアウォール設定をしたくない場合や、OpenSUSEで既にfirewalldを使っている場合はこのセクションはスキップしてOKです。

ポート80/443と22を許可する必要があります。

ufwのインストール​

すでにufwがインストール済みならこのステップはスキップしてください。

sudo apt-get install -y ufw

必要なポートを開放​

sudo ufw allow http
sudo ufw allow https
sudo ufw allow OpenSSH

ファイアウォールを有効化​

警告

この操作で許可していないポートへのアクセスはすべてブロックされます。実行前にホワイトリスト設定を必ず確認してください。

以下のコマンドでファイアウォールを有効にします。

sudo ufw enable

まとめ​

おめでとうございます！GitLabのインストールが無事完了しました。もし質問や問題があれば、毎日対応しているサポートチームまでお気軽にお問い合わせください。

さらに細かい設定をしたい場合は、公式GitLabドキュメントの次のステップを読むことをおすすめします。

クッキー設定