TeamCity On-Premises 2026.2 Help

サーバーインストールの構成

サーバーポートの変更。

別のアプリケーションが TeamCity サーバーと同じポートを使用している場合、サーバーは起動できません。 その結果、サーバーログまたはサーバーコンソールに「すでに使用されている住所 」エラーが表示されます。

.exe からサーバーをインストールする場合は、インストールウィザードでポートをカスタマイズできます。

インストール / 解凍されたサーバーのポートを変更するには、 <TeamCity ホームディレクトリ>/conf/server.xml ファイルを開き、コメントされていない <コネクター> XML ノードに別の番号を設定します。

<Connector port="8111" ...

変更を適用するには、で サーバーを再起動します。

稼働中の TeamCity サーバーのポートを変更する場合は、サーバーの保存済み URL すべて（ブラウザーのブックマーク、エージェントの サーバー URL プロパティ 、ユーザーの IDE 内の URL、 管理 | グローバル設定 ページの サーバー URL 設定）でも変更する必要があります。
同じマシンで別の Tomcat サーバーを実行している場合は、Tomcat サーバーの他のサービスポートも変更する必要がある場合があります（ポート= を server.xml ファイルで検索してください）。

HTTPS プロトコルを使用する場合は、別途有効にする必要があります。 プロセスは、使用する Web サーバー (デフォルトでは Tomcat) に固有です。 TeamCity ウェブ UI の HTTPS を構成する方法についての注記を参照してください。

サーバーコンテキストの変更

デフォルトでは、TeamCity サーバーにはサーバーアドレスのルートコンテキスト (例: http://localhost:8111/) でアクセスできます。 代わりにネストしたパス（たとえば http://localhost:8111/teamcity/ ）で利用できるようにするには、次の手順を実行する必要があります。

  1. TeamCity サーバーを停止します。

  2. <TeamCity ホームディレクトリ>\webapps\ROOT ディレクトリの名前を <TeamCity ホームディレクトリ>\webapps\teamcity に変更します。

  3. TeamCity サーバーを起動します。

TeamCity サーバーのメモリ設定を構成する

TeamCity サーバーには、子プロセスも起動できるメインプロセスがあります。 子プロセスは、マシンで使用可能なメモリを使用します。 このセクションでは、特別な構成が必要なため、メインの TeamCity サーバープロセスのメモリ設定のみを扱います。

JVM アプリケーションとして、TeamCity のメインサーバープロセスは JVM で使用可能なメモリのみを使用します。 必要なメモリは JVM ビット数 (64- または 32 ビット) によって異なります。 JVM が使用するメモリは通常、 ヒープ (-Xmx で構成) と メタスペース (使用可能なネイティブメモリの量によって制限されます)、内部 JVM (通常は数十 MB)、およびメモリマップファイルなどの OS 依存のメモリ機能で構成されます。 TeamCity は主にヒープメモリに依存します。 ヒープメモリサイズを構成するには、次の手順を実行します。

  1. TeamCity サーバーを停止します。

  2. sysdm.cpl コマンドを実行し、 詳細 | 環境変数 に移動します。

  3. システム変数セクションに TEAMCITY_SERVER_MEM_OPTS エントリが存在するかどうかを確認し、存在しない場合は追加します。

  4. このプロパティを Xmx<サイズ> 値に設定します。 例: TEAMCITY_SERVER_MEM_OPTS=-Xmx3g。 その他の例については、下の段落を参照してください。

  5. サーバーマシンを再起動します。

  6. サーバーの再起動後に、 TeamCity サーバーを起動します。

  1. TeamCity サーバーを停止します。

  2. /etc/environment ファイルを開きます。

  3. ファイルに TEAMCITY_SERVER_MEM_OPTS 行が存在するかどうかを確認し、存在しない場合は追加します。

  4. このプロパティを Xmx<サイズ> 値に設定します。 例: TEAMCITY_SERVER_MEM_OPTS=-Xmx3g。 その他の例については、下の段落を参照してください。

  5. ファイルを保存し、サーバーマシンを再起動します。

  6. サーバーの再起動後に、 TeamCity サーバーを起動します。

TEAMCITY_SERVER_MEM_OPTS 変数の可能な値:

  • 最小設定: 64 ビット Java の場合は -Xmx1024m (バンドル)、32 ビット Java の場合は -Xmx750m

  • 中規模サーバーの推奨設定: 64 ビット Java の場合は -Xmx2048m 、32 ビット Java の場合は -Xmx1024m。 32 ビット Java でより大きな設定を使用すると、 OutOfMemoryError が発生し、" ネイティブメモリの割り当て (malloc) に失敗しました" を伴う JVM クラッシュや "新しいネイティブスレッドを作成できません" メッセージにつながる可能性があります。

  • 大規模サーバーの推奨設定 (64 ビット Java を使用してください): -Xmx4g。 この設定は、エージェントが 2 百台まで、ビルド構成が数千あるインストール環境に適しています。 カスタムプラグインでは、 Xmx パラメーターで定義される値を増やす必要がある場合があります。

  • 大規模サーバーの最大設定 (64 ビット Java を使用してください): -Xmx10g。 より大規模な TeamCity インストールでは、より大きな値を使用できます。 ただし、一般的には、TeamCity サポートに相談せずに 10g より大きな値を使用することは推奨されません。

新しいサーバーのインストールでは、 ReservedCodeCacheSize=640m 属性がデフォルトで設定されます。 TeamCity 2022.04.4 より前に属性が指定されていた場合は、アップグレード後に手動で更新する必要があります。

OutOfMemory エラーが発生する場合、または TeamCity UI にメモリ関連の警告が継続的に表示される場合は、設定を次のレベルに引き上げる必要があります。

TeamCity データディレクトリを構成する

TeamCity データディレクトリのデフォルトの配置は変更できます。 詳細については、 この記事を参照してください。

本番環境で使用するためのサーバーの構成

すぐに使用できる TeamCity サーバーインストールは、評価目的に適しています。 本番環境で使用する場合は、追加の構成を実行する必要があります。 通常、次の手順が含まれます。

2026 年 9 月 11 日
TeamCity サーバーを起動するTeamCity サーバー始動プロパティの設定