TeamCity オンプレミス 2026.1 ヘルプ

TeamCity サーバーを起動

サーバーの起動

TeamCity が .exe または .tar.gz ディストリビューションを使用してインストールされている場合、 <TeamCity Home> /bin ディレクトリにある teamcity-server スクリプトによって起動および停止できます。スクリプトは、run (同じコンソールで実行)、start (新しい分離プロセスを開始してスクリプトを終了)、および stop コマンドを受け入れます。TeamCity を再起動するには、stop を送信し、停止したら start を送信します。

(評価のみ)TeamCity サーバーと 1 つのデフォルトエージェントを同時に起動 / 停止するには、runAll スクリプトを使用、例:

  • runAll.bat start を使用して、サーバーとデフォルトのエージェントを起動します。

  • runAll.bat stop を使用して、サーバーとデフォルトエージェントを停止します。

TeamCity サーバーのみを起動 / 停止するteamcity-server スクリプトを使用して必要なパラメーターを渡します。使用方法を確認するには、パラメーターなしでスクリプトを起動します。teamcity-server スクリプトは、stop コマンドに対して以下のオプションをサポートします。

  • stop n — 停止コマンドを TeamCity サーバーに送信し、プロセスが終了するまで最大 n 秒待機します。

  • stop n -force — 停止コマンドを TeamCity サーバーに送信し、プロセスが終了するまで最大 n 秒待機し、停止しなかった場合はサーバープロセスを終了します。

TeamCity サーバーが Windows サービスとしてインストールされている場合は、サービスを開始および停止する通常の手順に従います。

サーバーに特別なプロパティを渡す必要がある場合は、この記事を参照してください。

オペレーティングシステムを使用して、マシン上で TeamCity の自動起動を設定できます (macOS の例を参照)。

自動サーバー起動

このセクションでは、起動時に TeamCity サーバーを自動的に起動するようにシステムを構成する方法について説明します。

  1. .exe インストールから TeamCity をインストールする場合は、「サーバー> Windows サービス」オプションがオンになっていることを確認してください。

    TC Windows Installer
  2. コントロールパネルから Windows サービスウィンドウを開くか、services.msc コマンドを実行します。

  3. TeamCity サーバーサービスのスタートアップの種類を「自動」に設定します。

詳細については、この Microsoft の記事を参照してください: サービスの自動開始

    1. TeamCity をインストールし、コマンドラインから bin/teamcity-server.sh start を使用して起動した場合に動作することを確認します。

    2. systemd サービス構成ファイルを作成します。

      TEAMCITY_HOME="/opt/teamcity" # Replace with the actual TeamCity Server installation directory LINUX_USERNAME="my_username" # Replace with the Linux user account that should run the service LINUX_USERGROUP="my_groupname" # Replace with the primary group of that user sudo tee /etc/systemd/system/teamcity-server.service > /dev/null <<EOF [Unit] Description=TeamCity Server After=network.target [Service] Type=forking PIDFile=$TEAMCITY_HOME/logs/teamcity.pid ExecStart=$TEAMCITY_HOME/bin/teamcity-server.sh start ExecStop=$TEAMCITY_HOME/bin/teamcity-server.sh stop User=$LINUX_USERNAME Group=$LINUX_USERGROUP EnvironmentFile=/etc/environment [Install] WantedBy=multi-user.target EOF
    3. 再起動時にサービスの起動を有効にして、サービスを開始します。

      sudo systemctl enable teamcity-server.service sudo systemctl start teamcity-server.service
      1. TeamCity をインストールし、bin/teamcity-server.sh start を使用してコマンドラインから開始した場合に機能することを確認します。この命令は、TeamCity が /Library/TeamCity にインストールされていることを前提としています。

      2. 次の内容で /Library/LaunchDaemons/jetbrains.teamcity.server.plist ファイルを作成します。

        <?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "https://www.apple.com/DTDs/PropertyList-1.0.dtd"> <plist version="1.0"> <dict> <key>WorkingDirectory</key> <string>/Library/TeamCity</string> <key>Debug</key> <false/> <key>Label</key> <string>jetbrains.teamcity.server</string> <key>OnDemand</key> <false/> <key>KeepAlive</key> <true/> <key>ProgramArguments</key> <array> <string>/bin/bash</string> <string>--login</string> <string>-c</string> <string>bin/teamcity-server.sh run</string> </array> <key>RunAtLoad</key> <true/> <key>StandardErrorPath</key> <string>logs/launchd.err.log</string> <key>StandardOutPath</key> <string>logs/launchd.out.log</string> </dict> </plist>
      3. 次のコマンドを実行してファイルをテストします。

        launchctl load /Library/LaunchDaemons/jetbrains.teamcity.server.plist

        このコマンドは TeamCity サーバーを起動するはずです(これは logs/teamcity-server.log から、あなたのブラウザーで見ることができます)。

      4. ルート権限で TeamCity を開始したくない場合は、.plist ファイルで UserName キーを指定します(例:

        <key>UserName</key> <string>teamcity_user</string>

      TeamCity サーバーは、マシンの起動時に自動的に起動するようになりました。TeamCity ビルドエージェントの自動開始を構成するには、専用のセクションを参照してください。

        TeamCity UI を起動する

        TeamCity UI には、Web ブラウザーを介してアクセスできます。デフォルトのアドレスは、exe ディストリビューションの場合は http://localhost/ tar.gz ディストリビューションの場合は http://localhost:8111/ です。必要に応じて、サーバーポートを変更する方法を参照してください。

        インストールが成功した後、TeamCity UI にアクセスできない場合は、トラブルシューティングのセクションを参照してください。

        TeamCity インストールのトラブルシューティング

        TeamCity UI にアクセスできない場合は、以下を確認してください。

        • TeamCity サーバーサービスが実行されています (TeamCity を Windows サービスとしてインストールした場合)。

        • TeamCity サーバープロセス (Tomcat) が実行中です ( <TeamCity Home> /bin ディレクトリで実行される Java プロセス)。

        • サーバーをコンソールから実行した場合のコンソール出力の警告。

        • エラーメッセージ用の teamcity-server.log ファイルおよび <TeamCity Home> \logs ディレクトリ内のその他のファイル。

        サーバーのインストールで最も一般的な問題の 1 つは、別のプログラムですでに使用されているポートを使用することです。デフォルトのポートを変更する方法を参照してください。

        2025 年 10 月 01 日