結論
fatal: not a git repository (or any of the parent directories): .git は、「今いるフォルダーから上へ順にたどっても、Git のリポジトリ(.git)が見つからなかった」という意味です。多くは、リポジトリの外のフォルダーでコマンドを打っているか、git init・git clone の前です。pwd で場所を確かめ、git rev-parse --show-toplevel が通るフォルダーへ移ると直ります。
この記事でわかること
- not a git repository の原因19通りを実際に起こしたエラー原文と、直したあとの出力
- worktree・サブモジュール・GIT_DIR・Docker・CI で出るときの見分け方と直し方
- detected dubious ownership・does not appear to be a git repository との違いと判断表
この記事で実際に動かしたもの:Git 2.43.0 で、ローカルのフォルダーだけを使ってリポジトリ・ベアリポジトリ・worktree・サブモジュールを作り、not a git repository になる操作を1つずつ実行して、エラーの原文、strace で見た探し方、直したあとの出力を記録しました。
flowchart TD
S[今のフォルダー] --> Q{.git がある?}
Q -->|ある| OK[リポジトリ]
Q -->|無い| U[1つ上へ]
U --> L{上が無い?}
L -->|まだ| Q
L -->|着いた| F[fatal: not a<br>git repository]
やりたいことごとに、いちばん早い方法を先にまとめます。
| やりたいこと | いちばん早い方法 | 詳しい節 |
|---|---|---|
| fatal: not a git repository の意味を知りたい | 今のフォルダーとその上に .git が無い、という意味 | エラー文の読み方 |
| どのフォルダーにいるか確かめたい | pwd(Windows のコマンドプロンプトは cd) | 原因1:違うフォルダー |
| git clone した直後に出る | clone で作られたフォルダーに cd してから実行 | 原因1:違うフォルダー |
| 新しいプロジェクトで出る | そのフォルダーで git init(既存なら git clone) | 原因2:init・clone の前 |
| 昨日まで動いていたのに出る | ls -la .git と cat .git/HEAD で消えた・壊れたを見る | 原因3:.git が消えた・壊れた |
| エラー文の最後にパスが付いている | .git ファイルの gitdir の先を確かめ、worktree repair か submodule update | worktree とサブモジュール |
| Docker・CI の中でだけ出る | checkout の有無と .dockerignore を確かめる。コミットは引数で渡す | Docker・CI |
| detected dubious ownership と出る | 別の原因。safe.directory に登録するか所有者を合わせる | dubious ownership との見分け方 |
確認環境:Ubuntu 24.04 LTS(Linux カーネル 6.18)の上の Git 2.43.0(Ubuntu のパッケージ)で、作業用のフォルダーの中だけでリポジトリを作って実行しました。git の設定がホームに残らないよう、HOME と GIT_CONFIG_GLOBAL を作業用のフォルダーに向け、GIT_CONFIG_NOSYSTEM=1 でシステムの設定も読まない状態にしています。リモートは同じマシンの中のベアリポジトリ(ローカルのパス)だけで、外部のサービスには接続していません。所有者が違うリポジトリは nobody に chown して作り、ファイルシステムの境界は自分のマウント名前空間(unshare -m)の中だけで tmpfs を作って再現しました。Docker のデーモンはこの環境に無いため、ビルドコンテキストから .git が外れる状況は .dockerignore と同じ除外で作ったフォルダーで再現し、BuildKit の扱いは Docker Docs で確かめました。GitHub Actions・GitLab CI・Windows・Mac の挙動は手元で動かせないため、actions/checkout の README、GitLab Docs、Microsoft Learn、git-scm.com の公式ドキュメントで確かめた範囲だけを書いています。出力に出るパスは、読みやすさのため作業用のフォルダーを /work に置き換えました。図は mermaid で描画を確かめています(確認日 2026年11月5日)。
本記事の内容は、ご自由にお使いください。
ご利用の際は、出典として本ページへのリンクを記載いただけますようお願いします。
(記載例)出典:株式会社RJC「fatal: not a git repositoryの原因と直し方|19通り再現」
fatal: not a git repositoryとは(エラー文の読み方と探し方)
この節では、エラー文の各部分が何を言っているのか、Git がリポジトリをどう探しているのかが分かります。
Git のコマンドは、まず「どのリポジトリの話か」を決めます。決められなかったときに出るのが fatal: not a git repository です。リポジトリの外のフォルダーで git status を打ったときの原文は次のとおりです。
$ pwd
/work/notrepo
$ git status
fatal: not a git repository (or any of the parent directories): .git
$ echo $?
128
読む場所は3つです。
1not a git repository
今のフォルダーは Git のリポジトリではない、という判定。ファイルが壊れたという意味ではなく、「どのリポジトリか決められない」という意味。
2(or any of the parent directories)
上のフォルダーも順に見たが、どこにも無かった。サブフォルダーで打っても通常は動くのはこのため。
3.git
探した名前。リポジトリの一番上にある .git というフォルダー(worktree やサブモジュールでは .git というファイル)が目印。
4終了コード 128
Git が致命的なエラー(fatal)で止まったときの値。この記事で再現したエラーは、別の文言のものも含めてすべて 128 だった。
Git は上のフォルダーへ1つずつたどって探す
Git が実際に何を調べているかを、strace でリポジトリの外の深いフォルダー(/work/notrepo/a/b)から確かめました。各フォルダーで .git、.git/HEAD、そして HEAD の3つを調べ、無ければ1つ上へ移っています。最後の HEAD は、.git を持たないベアリポジトリ(そのフォルダー自体がリポジトリ)を見つけるための確認です。
newfstatat(AT_FDCWD, "/work/notrepo/a/b/.git", ...) = -1 ENOENT (No such file or directory)
newfstatat(AT_FDCWD, "/work/notrepo/a/b/.git/HEAD", ...) = -1 ENOENT (No such file or directory)
newfstatat(AT_FDCWD, "/work/notrepo/a/b/HEAD", ...) = -1 ENOENT (No such file or directory)
newfstatat(AT_FDCWD, "/work/notrepo/a/.git", ...) = -1 ENOENT (No such file or directory)
newfstatat(AT_FDCWD, "/work/notrepo/a/.git/HEAD", ...) = -1 ENOENT (No such file or directory)
newfstatat(AT_FDCWD, "/work/notrepo/a/HEAD", ...) = -1 ENOENT (No such file or directory)
(中略:/work/notrepo、/work、その上のフォルダーも同じ3つを調べる)
newfstatat(AT_FDCWD, "/.git", ...) = -1 ENOENT (No such file or directory)
newfstatat(AT_FDCWD, "/.git/HEAD", ...) = -1 ENOENT (No such file or directory)
newfstatat(AT_FDCWD, "/HEAD", ...) = -1 ENOENT (No such file or directory)
ルート(/)まで見て何も無かったので、fatal で止まりました。反対に、リポジトリの中の深いサブフォルダーでは、上へたどった先で .git が見つかり、普通に動きます。
$ pwd
/work/proj/src/deep
$ git rev-parse --show-toplevel
/work/proj
$ git status --short --branch
## main
エラー文は、何が理由で探索が止まったかによって形が変わります。手元で出た形を並べました。
| エラー文の形(原文) | 意味 | 主な原因 |
|---|---|---|
| fatal: not a git repository (or any of the parent directories): .git | ルートまでたどったが無い | 違うフォルダー・init 前・.git の削除や破損 |
| fatal: not a git repository (or any parent up to mount point /dev) | ファイルシステムの境界で止まった | 別ディスク・tmpfs・コンテナのマウントの中 |
| fatal: not a git repository: '/work/nope' | 指定されたパスがリポジトリではない | GIT_DIR・--git-dir の誤り |
| fatal: not a git repository: …/.git/worktrees/wt-feature | .git ファイルの指す先が無い | worktree・サブモジュールのリンク切れ |
| fatal: this operation must be run in a work tree | リポジトリはあるが作業ツリーが無い | ベアリポジトリの中で実行 |
not a git repositoryの原因一覧(症状→原因→直し方)
この節では、手元で再現した原因を、症状から引ける一覧で確かめられます。
原因は「場所が違う」「.git がまだ無い・消えた・壊れた」「.git の指す先が無い」「探し方が制限されている」の4つに分かれます。エラーの文言と、起きたきっかけから引けるように並べました。
| 症状 | 原因 | 直し方 |
|---|---|---|
| ターミナルを開いてすぐ git status | リポジトリの外のフォルダーにいる | cd でプロジェクトへ移る |
| git clone の直後に出る | clone で作られた下のフォルダーに入っていない | cd リポジトリ名 |
| 新しいフォルダーで git add . が失敗 | git init をしていない | git init(または git clone) |
| .git を消した・コピーで落ちた | .git が無い | clone し直すか、init+fetch+reset |
| .git はあるのに出る | HEAD の中身が壊れた | HEAD を ref: refs/heads/main に戻す |
| .git はあるのに出る(2) | objects か refs のフォルダーが無い | 戻せなければ clone し直す |
| zip で受け取ったフォルダーで出る | .git が無い・.GIT や git に名前が変わった | .git に戻すか clone し直す |
| エラー文の最後に .git/worktrees/… が付く | worktree の本体を動かした・管理情報を消した | git worktree repair・prune |
| エラー文の最後に .git/modules/… が付く | サブモジュールをコピーした・管理情報を消した | git submodule update --init |
| not a git repository: '…'(引用符つき) | GIT_DIR・--git-dir の指定が誤り | unset GIT_DIR、パスを直す |
| サブフォルダーでだけ出る | GIT_CEILING_DIRECTORIES で探索が止められている | 変数を見直す |
| up to mount point と出る | ファイルシステムの境界で止まった | リポジトリの一番上で実行 |
| CI でだけ出る | checkout の手順が無い・別のフォルダーへ cd | checkout を置き、作業フォルダーを合わせる |
| docker build でだけ出る | .dockerignore や Git コンテキストで .git が外れた | コミットはビルド引数で渡す |
エラーにはならないものの、間違えやすい状態も2つありました。初期化していないサブモジュールの空のフォルダーでは、上の親リポジトリが見つかってしまい、親の話としてコマンドが動きます。ホームフォルダーで誤って git init していると、その下のすべてのフォルダーが「リポジトリの中」になります。どちらも後の節で原文を載せます。
原因1:違うフォルダーにいる(pwdとrev-parseで確かめる)
この節では、いちばん多い「リポジトリの外にいる」場合の確かめ方と直し方が分かります。
ターミナルを新しく開くと、多くの場合はホームフォルダーから始まります。プロジェクトのフォルダーへ cd する前に git を打つと、このエラーになります。
pwd で今いる場所を出す
Linux・Mac のターミナルと Git Bash は pwd、Windows のコマンドプロンプトは引数なしの cd、PowerShell は Get-Location。思っていたプロジェクトのパスかを見る。
.git があるフォルダーを探す
ls -la(Windows は dir /a、PowerShell は Get-ChildItem -Force)で .git が見えるフォルダーがリポジトリの一番上。.git は隠しフォルダーなので、普通の ls や dir では出ない。
cd で移ってから git を打つ
cd /path/to/project のあと git status。サブフォルダーの中でもよい。
git rev-parse --show-toplevel で確かめる
リポジトリの中なら一番上のフォルダーの絶対パスが出る。外なら同じ fatal が出る。スクリプトの最初に置くと、場所の誤りに早く気付ける。
git clone の直後に出るのは、下のフォルダーに入っていないため
git clone は、今のフォルダーの下にリポジトリ名のフォルダーを作ります。clone したフォルダーのまま git status を打つと、まだリポジトリの外です。
$ git clone /work/remote.git myapp
Cloning into 'myapp'...
done.
$ git status
fatal: not a git repository (or any of the parent directories): .git
$ cd myapp && git status --short --branch
## main...origin/main
Cloning into 'myapp' の行に、作られたフォルダーの名前が出ています。clone の使い方とブランチの指定は、関連記事「git cloneの使い方|ブランチ指定とshallow clone」で扱っています。
git -C で場所を指定するときの2つのエラー
git -C パス は「そのフォルダーで実行したことにする」指定です。パスそのものが無いときと、パスはあるがリポジトリではないときで、エラーが分かれました。
$ git -C /work/nodir status
fatal: cannot change to '/work/nodir': No such file or directory
$ git -C /work/notrepo status
fatal: not a git repository (or any of the parent directories): .git
cannot change to と出たら、パスの綴りの誤りです。not a git repository と出たら、パスはあるのでリポジトリの位置の誤りです。
原因2:git initやgit cloneの前(.gitがまだ無い)
この節では、新しいフォルダーや、Git 管理されていないフォルダーで出る場合の直し方が分かります。
.git は git init か git clone で作られます。どちらもしていないフォルダーは、中身がプログラムでもリポジトリではありません。新しく作ったフォルダーで git add を打ったときの原文と、git init のあとの出力です。
$ git add .
fatal: not a git repository (or any of the parent directories): .git
$ git init
hint: Using 'master' as the name for the initial branch. This default branch name
hint: is subject to change. To configure the initial branch name to use in all
hint: of your new repositories, which will suppress this warning, call:
hint:
hint: git config --global init.defaultBranch <name>
hint:
hint: Names commonly chosen instead of 'master' are 'main', 'trunk' and
hint: 'development'. The just-created branch can be renamed via this command:
hint:
hint: git branch -m <name>
Initialized empty Git repository in /work/newapp/.git/
$ git status --short
?? index.html
hint の行は、最初のブランチ名を決めていないときの案内で、エラーではありません。git init -b main とするか、git config --global init.defaultBranch main を一度設定すると出なくなります。
git init を使う
手元にしか無い新しいプロジェクト
ZIP で受け取ったコードを自分で管理し始める
あとから GitHub などにリモートを足す
git clone を使う
GitHub・GitLab などに既にリポジトリがある
チームの履歴とブランチを受け取りたい
ZIP のコードの元のリポジトリが分かっている
既にリポジトリがあるのに git init で始めると、リモートの履歴とつながらない別のリポジトリができます。元のリポジトリがあるなら clone が先です。既存のフォルダーを git init から最初の push まで進める手順は、関連記事「git initの使い方|既存フォルダを最初のpushまで進める手順」で扱っています。
既存のリポジトリで git init をもう一度打っても履歴は消えない
「init したら壊れるのでは」と迷う場面があるので、既存のリポジトリで試しました。
$ git init
Reinitialized existing Git repository in /work/proj/.git/
$ git log --oneline -1
595a45c add submodule
Reinitialized と出て、コミットはそのまま残りました。ただし、場所を間違えて上のフォルダーで init すると、次の FAQ にあるホームフォルダーの問題が起きます。
原因3:.gitが消えた・壊れた(HEAD・objects・refs)
この節では、昨日まで動いていたリポジトリで急に出る場合の確かめ方と、取り戻し方が分かります。
Git は .git というフォルダーがあるだけでは、リポジトリと判断しません。中の HEAD・objects・refs がそろっていないと、.git があっても not a git repository になります。手元で1つずつ消したり壊したりした結果です。
| やったこと | git status の結果(原文) | 戻し方 |
|---|---|---|
| .git を削除 | fatal: not a git repository (or any of the parent directories): .git | clone し直すか init+fetch+reset |
| .git/HEAD を garbage に書き換え | 同じ | ref: refs/heads/main に戻す |
| .git/objects を別名に変更 | 同じ | 元に戻す。無ければ clone し直す |
| .git/refs を別名に変更 | 同じ | 元に戻す。無ければ clone し直す |
| .git を .GIT に変更 | 同じ(Linux では大文字小文字を区別) | .git に戻す |
| .git を git(ドットなし)に変更 | 同じ | .git に戻す |
HEAD を壊したときに、.git を直接指定しても同じ判定になりました。.git フォルダーがあるかではなく、中身が正しいかを見ていることが分かります。
$ cat .git/HEAD
garbage
$ git --git-dir=.git rev-parse HEAD
fatal: not a git repository: '.git'
$ printf 'ref: refs/heads/main\n' > .git/HEAD
$ git status --short --branch
## main...origin/main
HEAD の中身は、ふつう ref: refs/heads/ブランチ名 の1行です。どのブランチだったか分からなければ、ls .git/refs/heads で今あるブランチの名前を見て選びます。ディスクの不具合やエディターの誤保存で壊れることがあるので、直したあとに git fsck --full でほかに壊れた所が無いかを確かめます。
.git を消してしまったときの取り戻し方
作業中のファイルは残っていて .git だけが無い場合、リモートの履歴を持ってきて、今のファイルをその上に載せ直せます。手元のベアリポジトリをリモートにして試した手順です。
git init -b main
git remote add origin /work/remote.git # 実際は GitHub などの URL
git fetch origin
git reset origin/main # --hard は付けない
git branch -u origin/main
git status --short --branch
$ git reset origin/main
Unstaged changes after reset:
M a.txt
$ git branch -u origin/main
branch 'main' set up to track 'origin/main'.
$ git status --short --branch
## main...origin/main
M a.txt
消える前に編集していた a.txt の変更が、M(変更あり)として残りました。
.git を作り直してリモートに合わせるとき
push していないコミットまで取り戻す方法は Git にはありません。消す前の .git がバックアップやゴミ箱に残っていれば、それを戻すのが先です。
worktreeとサブモジュールで出るnot a git repository
この節では、エラー文の最後にパスが付く not a git repository の原因と、worktree・サブモジュールそれぞれの直し方が分かります。
worktree とサブモジュールの作業フォルダーでは、.git がフォルダーではなく1行のファイルで、本当のリポジトリの場所(gitdir)を指しています。その先が無くなると、指す先のパスつきでエラーになります。
$ cat /work/wt-feature/.git
gitdir: /work/proj/.git/worktrees/wt-feature
$ cat /work/super2/vendor/lib/.git
gitdir: ../../.git/modules/vendor/lib
worktree:本体のリポジトリを動かした・管理情報を消した
本体(/work/proj)のフォルダー名を変えると、worktree の .git ファイルが指す先が無くなりました。git worktree repair に新しい worktree の場所を渡すと、つながりが戻りました。
$ mv /work/proj /work/proj-moved
$ cd /work/wt-feature
$ git status
fatal: not a git repository: /work/proj/.git/worktrees/wt-feature
$ git -C /work/proj-moved worktree repair /work/wt-feature
repair: .git file broken: /work/wt-feature
$ git status --short --branch
## feature
$ git -C /work/proj-moved worktree list
/work/proj-moved c03c103 [main]
/work/wt-feature c03c103 [feature]
repair: .git file broken は「壊れていたので直した」という報告で、終了コードは 0 でした。git-scm.com の git worktree のドキュメントでは、本体を手で動かしたときは本体で repair を、worktree を手で動かしたときは worktree の中で repair を実行するよう書かれています。worktree を動かすなら、最初から git worktree move を使うとリンクごと直されます。
本体の .git/worktrees/ の中の管理情報を消した場合は、同じ形のエラーになり、repair では戻りません。作業中の変更を別の場所へ写してから worktree のフォルダーを消し、git worktree prune で残りを片付けて、git worktree add で作り直します。worktree の作り方と並列開発のコマンドは、関連記事「git worktreeの使い方|ブランチを同時に開く手順とコマンド早見表」で扱っています。
サブモジュール:フォルダーをコピーした・.git/modules を消した
サブモジュールの .git ファイルは、../../.git/modules/vendor/lib のように親から見た相対パスで書かれています。そのため、サブモジュールのフォルダーだけを別の場所へコピーすると、指す先が無くなりました。親の .git/modules の中を消した場合も同じです。
$ cp -r super2/vendor/lib copied-lib && cd copied-lib
$ git status
fatal: not a git repository: /work/copied-lib/../../.git/modules/vendor/lib
$ rm -rf super2/.git/modules/vendor/lib
$ cd super2/vendor/lib && git status
fatal: not a git repository: /work/super2/vendor/lib/../../.git/modules/vendor/lib
このとき、git submodule update --init --force だけでは直りませんでした。サブモジュールのフォルダーを消してから update --init すると、取り直されました。
$ git submodule update --init --force
fatal: could not get a repository handle for submodule 'vendor/lib'
$ rm -rf vendor/lib
$ git submodule update --init
Cloning into '/work/super2/vendor/lib'...
done.
Submodule path 'vendor/lib': checked out 'e3ab2b90460976e7d3ff9d09e5c48361a8822bc1'
$ git -C vendor/lib status --short --branch
## HEAD (no branch)
フォルダーを消す前に、サブモジュールの中で編集していたファイルは別の場所へ写しておきます。## HEAD (no branch) は、サブモジュールが親の記録したコミットを直接指している状態で、エラーではありません。
初期化していないサブモジュールでは「エラーにならない」のが落とし穴
サブモジュールを含むリポジトリを普通に clone すると、サブモジュールのフォルダーは空です。その中で git を打っても not a git repository にはならず、親のリポジトリが見つかります。
$ cd super2/vendor/lib
$ ls -la
total 8
drwxr-xr-x 2 root root 4096 Nov 5 10:40 .
drwxr-xr-x 3 root root 4096 Nov 5 10:40 ..
$ git rev-parse --show-toplevel
/work/super2
この状態で commit や checkout をすると、サブモジュールではなく親のリポジトリに対して実行されます。show-toplevel が親のパスを出したら、git submodule update --init --recursive で中身を取ってから作業します。空のサブモジュールの直し方と更新・削除は、関連記事「git submodule updateとは|空の直し方・–remote・削除」で扱っています。
GIT_DIR・GIT_CEILING_DIRECTORIES・ファイルシステムの境界
この節では、環境変数やマウントの仕方によって、リポジトリの中にいるのに not a git repository になる場合が分かります。
Git の探し方は、環境変数で変えられます。設定したことを忘れていたり、ツールが自動で設定していたりすると、リポジトリの中でもエラーになります。まず env | grep '^GIT_'(PowerShell は Get-ChildItem Env:GIT_*)で、GIT_ で始まる変数が残っていないかを見ます。
GIT_DIR・--git-dir:探さずに指定のパスだけを見る
git-scm.com の git のドキュメントでは、GIT_DIR(と --git-dir)を指定すると、.git を上へ探す処理は止まり、指定したパスがリポジトリとして使われると書かれています。リポジトリの中で、存在しないパスを指定した結果です。
$ cd /work/proj
$ GIT_DIR=/work/nope git status
fatal: not a git repository: '/work/nope'
$ git --git-dir=/work/nope status
fatal: not a git repository: '/work/nope'
$ GIT_DIR=/work/proj/.git git -C /work/notrepo rev-parse --git-dir
/work/proj/.git
引用符で囲まれたパスが出たら、GIT_DIR か --git-dir を疑います。unset GIT_DIR で消すか、正しいパスに直します。最後の行のように、GIT_DIR が正しければリポジトリの外からでも動きます。
GIT_CEILING_DIRECTORIES:ここより上は探さない
GIT_CEILING_DIRECTORIES は、遅いネットワークのフォルダーなどを探さないための「天井」です。ドキュメントでは、リポジトリを探すときにこの一覧のフォルダーへは上がらないと書かれています。天井をリポジトリの一番上(またはその途中)にすると、サブフォルダーからは見つからなくなりました。
$ cd /work/proj/src/deep
$ GIT_CEILING_DIRECTORIES=/work/proj git status
fatal: not a git repository (or any of the parent directories): .git
$ GIT_CEILING_DIRECTORIES=/work/proj/src git rev-parse --show-toplevel
fatal: not a git repository (or any of the parent directories): .git
エラー文は通常のものと同じなので、文言からは区別できません。リポジトリの一番上では動くのにサブフォルダーでだけ出るなら、この変数を確かめます。
up to mount point:ファイルシステムの境界で止まった
Git は、標準ではファイルシステムの境界(別のディスクや tmpfs などのマウント)を越えて上を探しません。リポジトリの中に別のファイルシステムをマウントし、その中で実行すると、エラー文が変わりました。
$ findmnt -T . -o TARGET,FSTYPE
TARGET FSTYPE
/work/proj/mnt tmpfs
$ git status
fatal: not a git repository (or any parent up to mount point /work/proj)
Stopping at filesystem boundary (GIT_DISCOVERY_ACROSS_FILESYSTEM not set).
$ GIT_DISCOVERY_ACROSS_FILESYSTEM=1 git rev-parse --show-toplevel
/work/proj
Stopping at filesystem boundary の行が出たら、この原因です。GIT_DISCOVERY_ACROSS_FILESYSTEM=1 にすると境界を越えて探しますが、ふだんはリポジトリの一番上で実行するほうが分かりやすくなります。リポジトリの外の /dev/shm(tmpfs)で実行したときも、(or any parent up to mount point /dev) の形で出ました。コンテナの中のボリュームや、別ディスクの作業フォルダーで見かける形です。
Docker・CIで出るnot a git repository(checkout忘れ・.dockerignore)
この節では、手元では動くのに Docker のビルドや CI でだけ出る場合の原因と直し方が分かります。
Docker のビルドと CI のジョブは、どちらも「リポジトリのファイルだけ」が渡され、.git が無いことがあります。git describe や git rev-parse HEAD でバージョンを作っている手順が、そこで止まります。
docker build:.dockerignore と Git コンテキストで .git が外れる
Docker Docs によると、.dockerignore に書いたファイルはビルダーへ送られる前にビルドコンテキストから外されます。また、Git リポジトリの URL をコンテキストにしたとき、BuildKit は標準では .git を残さず、残すにはビルド引数 BUILDKIT_CONTEXT_KEEP_GIT_DIR=1 を使うと書かれています。この環境には Docker のデーモンが無いため、.dockerignore と同じ除外でコンテキストのフォルダーを作り、その中で実行しました。
$ cat .dockerignore
.git
node_modules
$ ls -a # .dockerignore の除外を当てたコンテキストの中
.
..
.dockerignore
.gitmodules
a.txt
src
vendor
$ git rev-parse HEAD
fatal: not a git repository (or any of the parent directories): .git
.git を送らない設定は、イメージを小さくし、履歴をイメージに入れないための意味があります。そのため、.git をコンテキストに戻すより、ビルドする側でコミットを調べて引数で渡すほうが扱いやすくなります。
docker build --build-arg GIT_COMMIT=$(git rev-parse --short HEAD) -t myapp .
ARG GIT_COMMIT=unknown
ENV APP_COMMIT=$GIT_COMMIT
手元のリポジトリで $(git rev-parse --short HEAD) を展開すると --build-arg GIT_COMMIT=595a45c になりました。コンテナにフォルダーをマウントして git を動かしたときに出る detected dubious ownership は、次の節で扱います。
CI:checkout の手順が無い・別のフォルダーへ移った
GitHub Actions のジョブは、actions/checkout の手順を置かないとリポジトリを取ってきません。actions/checkout の README では、標準では1コミットだけを取得すること(fetch-depth の既定は 1)、PATH に Git 2.18 以降が無いと REST API でファイルだけをダウンロードすることが書かれています。後者の場合も .git は作られません。ランナーの作業フォルダーにファイルだけがある状態を作って、バージョンを作るよくある書き方を実行しました。
$ git describe --tags --always
fatal: not a git repository (or any of the parent directories): .git
$ echo "version=$(git rev-parse --short HEAD)"
fatal: not a git repository (or any of the parent directories): .git
version=
$ echo $?
0
2つ目は見落としやすい形です。$( ) の中で git が失敗しても、外の echo は成功するので、ジョブは止まらずに空のバージョンで先へ進みました。CI では、直す場所が3つあります。
- git を使う手順より前に actions/checkout を置く。タグや履歴を使うなら fetch-depth: 0 にする。
- 手順の中で cd /tmp などをしていないかを見る。リポジトリの場所は GITHUB_WORKSPACE(actions/checkout の path を指定したらその下)。
- GitLab CI では、GitLab Docs によると GIT_STRATEGY: empty はリポジトリのデータを置かず、none は Git の操作をしない(残っていても前のジョブのままの可能性がある)。git を使うジョブは clone か fetch にする。
スクリプト側では、失敗を空の値で隠さないように、最初に確かめておくと原因がログに残ります。
if ! git rev-parse --is-inside-work-tree >/dev/null 2>&1; then
echo "Git のリポジトリの外です: $(pwd)" >&2
exit 1
fi
VERSION=$(git describe --tags --always)
リポジトリが無くても動かしたい処理なら、git rev-parse --short HEAD 2>/dev/null || echo unknown のように、決めた値に置き換えます。手元では unknown が出ました。
detected dubious ownership(safe.directory)との見分け方
この節では、似た場面で出る detected dubious ownership と、リモートで出る does not appear to be a git repository が、not a git repository とどう違うかが分かります。
detected dubious ownership は、リポジトリは見つかったが、所有者が今のユーザーと違うので Git が使うのを断った、というエラーです。.git はあるので、git init や clone では直りません。nobody が所有するリポジトリを root で開いたときの原文です。
$ git status
fatal: detected dubious ownership in repository at '/work/owned'
To add an exception for this directory, call:
git config --global --add safe.directory /work/owned
$ git config --global --add safe.directory /work/owned
$ git status --short --branch
## main
終了コードは not a git repository と同じ 128 でした。git の終了コードだけを見て「リポジトリではない」と表示するツールでは、この2つが同じように見えることがあります。git のコマンドを直接打って、文言を確かめます。
safe.directory は、Git のドキュメントによると、リポジトリの中の設定には書けず、グローバルかシステムの設定(またはコマンドライン)で指定します。* を指定するとすべてのリポジトリで確認が止まるので、登録はそのパスだけにします。sudo で動かしたときは SUDO_UID のユーザーの所有も信頼されます。原因(コンテナのボリューム・別ユーザーのフォルダー・外付けディスク)ごとの直し方は、関連記事「detected dubious ownershipの直し方|git」で扱っています。
does not appear to be a git repository は「リモート」の話
文言が似ていますが、こちらは手元ではなく、push・fetch・pull の相手(リモート)が見つからないときのエラーです。
$ git push nowhere main
fatal: 'nowhere' does not appear to be a git repository
fatal: Could not read from remote repository.
Please make sure you have the correct access rights
and the repository exists.
引用符の中が、リモートの名前か URL です。git remote -v で名前と URL を見て、綴りやリポジトリの有無を確かめます。
| エラー | 何が見つからないか | 最初に打つコマンド |
|---|---|---|
| not a git repository | 手元のリポジトリ(.git) | pwd・ls -la |
| detected dubious ownership | 見つかったが所有者が違う | ls -ld フォルダー |
| does not appear to be a git repository | リモートのリポジトリ | git remote -v |
| this operation must be run in a work tree | 作業ツリー(ベアリポジトリの中) | git rev-parse --is-bare-repository |
ベアリポジトリ(サーバー側の remote.git のようなフォルダー)の中で git status を打つと、fatal: this operation must be run in a work tree になり、git rev-parse --is-bare-repository は true を返しました。作業するには、そのベアリポジトリを clone します。
OS・環境別のつまずき(Windows・Mac・Linux・VS Code)
この節では、使っている OS や道具ごとに、not a git repository の出やすい原因と確かめ方が分かります。
| 環境 | 出やすい原因 | 確かめ方 |
|---|---|---|
| Windows(コマンドプロンプト) | .git が隠しフォルダーで見えず、別のフォルダーにいると気付かない | cd で場所、dir /a で .git を表示 |
| Windows(PowerShell) | 同じ | Get-Location、Get-ChildItem -Force |
| Windows(エクスプローラー) | .git が見えないので、上のフォルダーをコピーして .git を落とす | 隠しファイルを表示してからコピー |
| Mac(ターミナル) | 新しいウィンドウはホームから始まる | pwd、ls -la |
| Linux・WSL | .GIT など大文字小文字の違い、別ディスクのマウント | ls -la、findmnt -T . |
| VS Code | リポジトリの上や外のフォルダーを開いている | ターミナルで git rev-parse --show-toplevel |
| Docker・CI | .git がコンテキストやワークスペースに無い | ls -a、checkout の手順 |
Windows の Git では、git-scm.com の core.hideDotFiles の説明によると、標準(dotGitOnly)で .git だけが隠し属性になります。Microsoft Learn によると、dir は /a を付けないと隠しファイルを表示せず、PowerShell の Get-ChildItem は -Force を付けると隠しファイルも取得します。エクスプローラーで見えないからといって、.git が無いとは限りません。
VS Code では、開いているフォルダーとターミナルの場所が違うことがあります。ソース管理の表示とは別に、ターミナルで pwd と git rev-parse --show-toplevel を打つと、どのフォルダーの話かがはっきりします。VS Code の公式ドキュメントでは、リポジトリが無いフォルダーでは、ソース管理からリポジトリを初期化して最初のコミットまで進める流れが案内されています。
判断表:not a git repositoryが出たらどこから確かめるか
この節では、エラー文の形から、どの順番で確かめれば早いかが分かります。
エラー文の最後の部分で、原因はかなり絞れます。上から順に当てはまるものを探します。
- 1detected dubious ownership → 所有者.git はある。ls -ld で所有者を見て、safe.directory に登録するか所有者を合わせる
- 2引用符つきのパス → GIT_DIRenv | grep '^GIT_' で変数を見て、unset GIT_DIR かパスを直す
- 3worktrees/… や modules/… → リンク切れcat .git で gitdir の先を見る。worktree は repair、サブモジュールはフォルダーを消して update --init
- 4up to mount point → 境界リポジトリの一番上で実行するか、GIT_DISCOVERY_ACROSS_FILESYSTEM=1
- 5parent directories → まず場所pwd と ls -la。.git のあるフォルダーへ cd。clone の直後なら下のフォルダーへ
- 6.git はあるのに出る → 中身cat .git/HEAD、ls .git で objects・refs を確かめ、戻すか clone し直す
- 7Docker・CI でだけ出る → .git が渡っていないcheckout の手順・作業フォルダー・.dockerignore。コミットは引数で渡す
| こういうとき | こうする | 避けたいこと |
|---|---|---|
| 元のリポジトリがある | git clone して cd | 同じコードで git init(履歴がつながらない) |
| 手元にしか無い新しいコード | git init -b main | ホームなど上のフォルダーで init |
| .git が消えて作業中の変更がある | init+fetch+reset(--hard なし) | reset --hard で上書き |
| worktree を動かしたい | git worktree move | mv で動かす(repair が要る) |
| サブモジュールを別の場所で使いたい | そのリポジトリを clone し直す | フォルダーをコピー(gitdir が切れる) |
| Docker でコミットを使いたい | --build-arg で渡す | .git をイメージに入れる |
| スクリプトで場所を確かめたい | git rev-parse --is-inside-work-tree で先に止める | $( ) の失敗を空の値で進める |
エラーを出さないために、作業の前に確かめておきたいことです。
- 1ターミナルを開いたら最初に pwdプロンプトに今のフォルダーとブランチ名を出す設定にしておくと、打つ前に気付ける
- 2clone のあとは必ず cdCloning into の行に出たフォルダー名へ移る
- 3フォルダーのコピーは .git ごと隠しファイルを表示してから。サブモジュールと worktree はコピーせず clone・move を使う
- 4スクリプトの最初で rev-parse場所の誤りを最初の行で止め、エラーにパスを出す
- 5GIT_ で始まる変数を残さない一時的に使った GIT_DIR・GIT_WORK_TREE は、使い終わったら unset
よくある質問
この節では、not a git repository について迷いやすい点への答えが分かります。
Q. サブフォルダーで git を打っても動きますか?
動きます。Git は今のフォルダーから上へ .git を探すので、リポジトリの中ならどの深さでも同じリポジトリとして扱われます。手元では /work/proj/src/deep で git rev-parse --show-toplevel が /work/proj を返しました。
Q. git init をもう一度打つと、履歴は消えますか?
既存のリポジトリの一番上で打った場合は消えません。Reinitialized existing Git repository と出て、コミットはそのまま残りました。注意が要るのは、違うフォルダー(とくに上の階層)で打った場合です。
Q. ホームフォルダーで git init してしまったようです。どうなりますか?
ホームの下のすべてのフォルダーが、そのリポジトリの中になります。試したところ、ホームの下のプロジェクトで git rev-parse --show-toplevel がホームを返し、git status --short は ?? ../ のように上のフォルダーまで未追跡として出しました。ホームの .git に必要な履歴が無いことを確かめてから、その .git だけを消すと元に戻ります。
Q. Windows で .git フォルダーが見当たりません。
Git for Windows では .git が隠しフォルダーになります。コマンドプロンプトの dir /a、PowerShell の Get-ChildItem -Force で表示されます。見えなくても、git rev-parse --show-toplevel が通ればリポジトリの中です。
Q. .git を消してしまいました。取り戻せますか?
push 済みの履歴は、リモートから取り戻せます。作業中のファイルが残っていれば、git init・git remote add・git fetch・git reset origin/main(--hard なし)で、変更を残したまま履歴をつなぎ直せます。push していないコミットとスタッシュは .git の中にしか無いので、バックアップが無ければ戻りません。
Q. スクリプトで「リポジトリの中か」を判定するには?git rev-parse --is-inside-work-tree を使います。中なら true を出して 0、外なら fatal を出して 128 で終わります。ベアリポジトリの中では false を出すので、作業ツリーが要る処理の判定に向いています。
Q. not a git repository と detected dubious ownership は同じ問題ですか?
違います。前者は .git が見つからない、後者は見つかったが所有者が違うので断った、という意味です。終了コードはどちらも 128 なので、ツールの表示ではなく git の文言で見分けます。
Q. does not appear to be a git repository は何が違いますか?
push・fetch・pull の相手(リモート)が見つからないエラーです。手元の .git は関係ありません。git remote -v で名前と URL を確かめます。
Q. VS Code では問題ないのに、ターミナルでだけ出ます。
VS Code のターミナルが、開いているフォルダーとは別の場所にいることがあります。ターミナルで pwd を打ち、リポジトリの中に cd してから実行します。
Q. Docker のビルドで git describe を使いたいときは?
.git を送らない設定のままにして、ビルドする側で git describe を実行し、--build-arg で値を渡す方法が扱いやすくなります。Git リポジトリの URL をコンテキストにする場合は、Docker Docs にあるビルド引数 BUILDKIT_CONTEXT_KEEP_GIT_DIR=1 で .git を残せます。
まとめ
- fatal: not a git repository は、今のフォルダーから上へたどっても .git が見つからないときのエラー。Git は各フォルダーで .git・.git/HEAD・HEAD を調べていた。
- いちばん多い原因は場所の誤り。pwd と ls -la で確かめ、.git のあるフォルダーへ cd する。clone の直後は下のフォルダーへ移る。
- .git があっても、HEAD が壊れていたり objects・refs が無かったりすると同じエラーになる。消えたときは init+fetch+reset(--hard なし)で変更を残せる。
- エラー文の最後に .git/worktrees/… や .git/modules/… が付いたら、.git ファイルのリンク切れ。worktree は repair、サブモジュールは update --init で直す。
- Docker・CI では .git が渡っていないことが多い。checkout を置き、コミットはビルド引数で渡す。dubious ownership と does not appear to be は別の原因。
直したあと、リポジトリを新しく始めるときは git init の記事、既存のリポジトリを受け取るときは git clone の記事、所有者のエラーが続くときは dubious ownership の記事が次の一歩になります(いずれも本文中でリンクしています)。
参考・出典
確認日はいずれも 2026年11月5日です。
- Git「git Documentation」(--git-dir・-C・GIT_DIR・GIT_CEILING_DIRECTORIES・GIT_DISCOVERY_ACROSS_FILESYSTEM):https://git-scm.com/docs/git
- Git「git-config Documentation」(safe.directory・core.hideDotFiles):https://git-scm.com/docs/git-config
- Git「git-worktree Documentation」(repair・prune・move):https://git-scm.com/docs/git-worktree
- Git「git-submodule Documentation」:https://git-scm.com/docs/git-submodule
- Git「git-rev-parse Documentation」(--show-toplevel・--is-inside-work-tree・--is-bare-repository):https://git-scm.com/docs/git-rev-parse
- GitHub「actions/checkout」README(fetch-depth・path・set-safe-directory):https://github.com/actions/checkout
- GitLab Docs「Configure runners」(GIT_STRATEGY):https://docs.gitlab.com/ci/runners/configure_runners/
- Docker Docs「Build context」(.dockerignore・BUILDKIT_CONTEXT_KEEP_GIT_DIR):https://docs.docker.com/build/concepts/context/
- Microsoft Learn「dir」:https://learn.microsoft.com/ja-jp/windows-server/administration/windows-commands/dir
- Microsoft Learn「Get-ChildItem」:https://learn.microsoft.com/ja-jp/powershell/module/microsoft.powershell.management/get-childitem
- Visual Studio Code「Source Control in VS Code」:https://code.visualstudio.com/docs/sourcecontrol/overview
本記事の内容は、ご自由にお使いください。
ご利用の際は、出典として本ページへのリンクを記載いただけますようお願いします。
(記載例)出典:株式会社RJC「fatal: not a git repositoryの原因と直し方|19通り再現」
株式会社RJC ― SI事業・SES事業・AI駆動開発。RJCは一緒に成長を楽しめる会社です。
WE ARE HIRING
RJCで一緒に開発しながら、
成長を楽しみませんか?
RJCは、Web・モバイル・AIを活用した開発プロジェクトで、テックリードやPM・PMOも活躍するシステム開発会社です。会社を知る、待遇を確かめる、話を聞いてみる。気になるところ見てみてください!
- 127日年間休日
- 12時間平均残業時間
- 毎日ガチャ遊びココロも大切にする福利厚生。アマギフなどの賞品ラインナップ!
ほかにも、チケットレストラン、書籍読み放題、2年ごとの慰労報奨(休暇 or 金一封)、11期連続の黒字決算。