正式なドキュメントは英語版であり、この日本語訳はAI支援翻訳により作成された参考用のものです。日本語訳の一部の内容は人間によるレビューがまだ行われていないため、翻訳のタイミングにより英語版との間に差異が生じることがあります。最新かつ正確な情報については、英語版をご参照ください。

DebianにLinuxパッケージをインストールする

  • プラン: Free、Premium、Ultimate
  • 提供形態: GitLab Self-Managed

サポートされているディストリビューションとアーキテクチャの完全なリストについては、サポートされているプラットフォームを参照してください。

前提要件

  • OS要件:
    • Debian 11
    • Debian 12
    • Debian 13
  • 最小ハードウェア要件については、インストール要件を参照してください。
  • 開始する前に、DNSを設定していることを確認してください。以下のコマンドのhttps://gitlab.example.comを、希望するGitLab URLに置き換えてください。GitLabは、そのアドレスで自動的に設定および開始されます。
  • https:// URLの場合、GitLabはLet’s Encryptで証明書をリクエストします。これには、受信HTTPアクセスと有効なホスト名が必要です。独自の証明書を使用することも、暗号化されていないURLの場合はhttp://（sなし）を使用することもできます。

SSHを有効にし、ファイアウォールポートを開きます

必要なファイアウォールポート（80、443、22）を開き、GitLabにアクセスできるようにするには:

  1. OpenSSHサーバーデーモンを有効にして起動します:

    sudo systemctl enable --now ssh

  2. ufwをインストールした状態で、ファイアウォールポートを開きます:

    sudo ufw allow 22/tcp
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw enable

GitLabパッケージリポジトリを追加する

GitLabをインストールするには、まずGitLabパッケージリポジトリを追加します。

  1. 必要なパッケージをインストールします:

    sudo apt install -y curl

  2. 次のスクリプトを使用してGitLabリポジトリを追加します（スクリプトのURLをブラウザに貼り付けて、bashにパイプする前に何をするかを確認できます）:

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

パッケージをインストールします。

システムのパッケージマネージャーを使用してGitLabをインストールします。

EXTERNAL_URLの設定はオプションですが、推奨されています。インストール中に設定しなかった場合は、後で設定できます。

sudo EXTERNAL_URL="https://gitlab.example.com" apt install gitlab-ee
sudo EXTERNAL_URL="https://gitlab.example.com" apt install gitlab-ce

GitLabは、root管理者アカウントのランダムなパスワードとメールアドレスを生成し、/etc/gitlab/initial_root_passwordに24時間保存します。24時間後、セキュリティ上の理由からこのファイルは自動的に削除されます。

最初のサインイン

GitLabがインストールされたら、セットアップしたURLにアクセスし、次の認証情報を使用してサインインします:

  • ユーザー名: root
  • パスワード: /etc/gitlab/initial_root_passwordを参照してください

サインイン後、パスワードとメールアドレスを変更します。

高度な設定

インストール前に次のオプションの環境変数を設定することで、GitLabのインストールをカスタマイズできます。これらの変数は、最初のインストール中にのみ機能します。また、後続の再構成の実行には影響しません。既存のインストールでは、/etc/gitlab/initial_root_passwordのパスワードを使用するか、rootパスワードをリセットします。

変数目的必須例
EXTERNAL_URLGitLabインスタンスの外部URLを設定します推奨EXTERNAL_URL="https://gitlab.example.com"
GITLAB_ROOT_EMAILroot管理者アカウントのカスタムメールオプションGITLAB_ROOT_EMAIL="admin@example.com"
GITLAB_ROOT_PASSWORDroot管理者アカウントのカスタムパスワード（最低8文字）オプションGITLAB_ROOT_PASSWORD="strongpassword"

GitLabがインストール中に有効なホスト名を検出できない場合、再構成は自動的に実行されません。この場合、必要な環境変数を最初のgitlab-ctl reconfigureコマンドに渡します。

gitlab_rails['initial_root_password']を設定して、/etc/gitlab/gitlab.rbで初期パスワードを設定することもできますが、お勧めしません。パスワードがクリアテキストであるため、セキュリティ上のリスクがあります。これが構成されている場合は、インストール後に必ず削除してください。

GitLabエディションを選択し、上記の環境変数でカスタマイズします:

sudo GITLAB_ROOT_EMAIL="admin@example.com" GITLAB_ROOT_PASSWORD="strongpassword" EXTERNAL_URL="https://gitlab.example.com" apt install gitlab-ee
sudo GITLAB_ROOT_EMAIL="admin@example.com" GITLAB_ROOT_PASSWORD="strongpassword" EXTERNAL_URL="https://gitlab.example.com" apt install gitlab-ce

コミュニケーションの優先順位を設定する

コミュニケーションを取るタイミングをお知らせいただくために、メールサブスクリプション設定センターにアクセスしてください。メールのオプトインポリシーを明示的に定めているため、メールの送信内容と頻度を完全に管理できます。

月に2回、新機能、インテグレーション、ドキュメント、開発チームからの舞台裏ストーリーなど、知っておく必要のあるGitLabニュースをお届けします。バグやシステムパフォーマンスに関連する重要なセキュリティ更新については、専用のセキュリティニュースレターにサインアップしてください。

セキュリティニュースレターにオプトインしない場合、セキュリティアラートは届きません。

インストールが完了したら、推奨される次のステップ（認証オプションやサインアップ制限など）を検討してください。