# Overlayfs에서 Overlay2로 전환 실패, 신규 설치, 스토리지 드라이버
**URL:** https://meta.discourse.org/t/overlayfs-to-overlay2-failed-on-fresh-installation-storage-driver/389126
**Category:** Support
**Tags:** docker, install
**Created:** [11월 20, 2025, 12:03오전 UTC](https://meta.discourse.org/t/overlayfs-to-overlay2-failed-on-fresh-installation-storage-driver/389126 "2025-11-20T00:03:23Z")
**Posts on this page:** 9
**Page:** 1
### Author:  [@iidbae](https://meta.discourse.org/u/iidbae)
#### Post date: [11월 20, 2025, 12:03오전 UTC](https://meta.discourse.org/t/overlayfs-to-overlay2-failed-on-fresh-installation-storage-driver/389126/1 "2025-11-20T00:03:23Z")
공식 설치 절차에 따라 `./discourse-setup`를 실행하고 호스트명, SMTP 포트 등을 입력한 후 오류 메시지가 표시됩니다.
> ENTER를 눌러 계속, 'n’을 눌러 다시 시도, Ctrl+C를 눌러 종료:
> letsencrypt.ssl.template.yml 활성화됨
>
> containers/app.yml 구성 파일이 성공적으로 업데이트되었습니다!
>
> 업데이트가 성공적으로 완료되었습니다. 5초 후 재빌드합니다.
> 앱 빌드 중
> Docker 설치에 지원되지 않는 스토리지 드라이버가 사용되고 있습니다. 계속 진행하면 설치가 손상될 수 있습니다.
> overlay2가 권장되는 스토리지 드라이버이지만, zfs와 aufs도 작동할 수 있습니다.
> 다른 스토리지 드라이버는 문제가 있는 것으로 알려져 있습니다.
> "docker info"를 실행하여 ‘Storage Driver’ 줄을 확인하면 현재 사용 중인 파일 시스템을 알 수 있습니다.
>
> 지원되지 않는 기존 스토리지 드라이버를 그대로 사용하려는 경우,
> launcher의 소스 코드를 읽고 이 확인을 우회하는 방법을 알아내야 합니다.
## Storage Driver Overlayfs에서 overlay2로 변경
Discourse AI 봇에 질문하고 이전 주제(예:)를 검색하며 시도해 보았습니다:
- [Troubleshoot docker installation issues](https://meta.discourse.org/t/troubleshoot-docker-installation-issues/13657)
- [Docker Upgrade Removed AUFS Storage Driver, Killed Discourse](https://meta.discourse.org/t/docker-upgrade-removed-aufs-storage-driver-killed-discourse/308181)
- [“Your Docker installation is not using a supported storage driver.”](https://meta.discourse.org/t/your-docker-installation-is-not-using-a-supported-storage-driver/159688/)
- [Change the Docker storage backend](https://meta.discourse.org/t/change-the-docker-storage-backend/75352)
하지만 여전히 작동하지 않습니다.
`root 3085 0.0 0.0 6480 2372 pts/1 S+ 05:27 0:00 grep --color=auto 2658`
## Docker 설치 불가
VPS 제공사를 DigitalOcean으로 변경하고 다른 두 곳의 VPS 제공사도 시도해 보았지만 여전히 실패했습니다.
처음에는 VPS 제공사 문제라고 생각했지만, **Digital Ocean에서 새로운 드롭렛으로 공식/표준 설치** 를 새로 진행해 보았음에도 여전히 **실패** 했습니다. 이후 다른 두 VPS 제공사로 변경해 보았지만 결과는 동일했습니다. 🤨
Ubuntu 버전 문제라고 생각하여 Ubuntu 24, 22, 20, 18 버전을 시도해 보았지만 여전히 실패했습니다.
```plaintext
Client: Docker Engine - Community
Version: 29.0.2
Context: default
Debug Mode: false
Plugins:
buildx: Docker Buildx (Docker Inc.)
Version: v0.30.0
Path: /usr/libexec/docker/cli-plugins/docker-buildx
compose: Docker Compose (Docker Inc.)
Version: v2.40.3
Path: /usr/libexec/docker/cli-plugins/docker-compose
model: Docker Model Runner (Docker Inc.)
Version: v1.0.0
Path: /usr/libexec/docker/cli-plugins/docker-model
Server:
Containers: 1
Running: 1
Paused: 0
Stopped: 0
Images: 3
Server Version: 29.0.2
Storage Driver: overlay2
Backing Filesystem: extfs
Supports d_type: true
Using metacopy: false
Native Overlay Diff: true
userxattr: false
Logging Driver: json-file
Cgroup Driver: systemd
Cgroup Version: 2
Plugins:
Volume: local
Network: bridge host ipvlan macvlan null overlay
Log: awslogs fluentd gcplogs gelf journald json-file local splunk syslog
CDI spec directories:
/etc/cdi
/var/run/cdi
Swarm: inactive
Runtimes: io.containerd.runc.v2 runc
Default Runtime: runc
Init Binary: docker-init
containerd version: fcd43222d6b07379a4be9786bda52438f0dd16a1
runc version: v1.3.3-0-gd842d771
init version: de40ad0
Security Options:
apparmor
seccomp
Profile: builtin
cgroupns
Kernel Version: 5.15.0-161-generic
Operating System: Ubuntu 22.04.5 LTS
OSType: linux
Architecture: x86_64
CPUs: 2
Total Memory: 2.407GiB
Name: please-help-me
ID: 398f33a7-2b49-4235-bcb9-4e1723a7bd81
Docker Root Dir: /var/lib/docker
Debug Mode: false
Experimental: false
Insecure Registries:
::1/128
127.0.0.0/8
Live Restore Enabled: false
Firewall Backend: iptables
```
도와주실 분 계신가요?
---
### Author:  [@pfaffman](https://meta.discourse.org/u/pfaffman)
#### Post date: [11월 20, 2025, 3:06오후 UTC](https://meta.discourse.org/t/overlayfs-to-overlay2-failed-on-fresh-installation-storage-driver/389126/2 "2025-11-20T15:06:47Z")
최근에 설정한 두 사이트에서 이 동작을 확인할 수 있습니다. `git.docker.com`에 문제가 있어 수년 동안 그랬던 것처럼 기본적으로 overlay2를 로드하지 못하고 있습니다.
다음 내용으로 `/etc/docker/daemon.json` 파일을 생성하세요:
```plaintext
{
"storage-driver": "overlay2"
}
```
그런 다음
```plaintext
sudo systemctl restart docker
```
을 실행합니다.
이후에는 정상적으로 작동해야 합니다. 다음 명령을 실행하여 설치된 드라이버를 확인할 수 있습니다.
```plaintext
docker info --format '{{.Driver}}'
```
---
### Author:  [@iidbae](https://meta.discourse.org/u/iidbae)
#### Post date: [11월 20, 2025, 3:17오후 UTC](https://meta.discourse.org/t/overlayfs-to-overlay2-failed-on-fresh-installation-storage-driver/389126/3 "2025-11-20T15:17:44Z")
> [@pfaffman](#):
>
> 최근에 설정한 최소 두 사이트에서 이 동작을 확인할 수 있습니다. `git.docker.com`에 문제가 있어, 수년 동안 그랬던 것처럼 기본적으로 overlay2를 로드하지 못합니다.
저도 마찬가지입니다…
즉, 현재 공식 discourse 설치 과정에서 문제가 있다는 뜻입니다.
digitalocean에서 [공식 설치 절차](https://github.com/discourse/discourse/blob/main/docs/INSTALL-cloud.md)를 시도해 보았지만 이 오류 메시지가 나타났습니다. 그러자 다른 VPS 제공업체로 옮겼는데, 결과는 똑같았습니다.
2025년 11월 지금, discourse의 신규 설치로 고생하고 계신 분들에게 😅 위 솔루션을 찾으시길 바랍니다 ☝
이것이 제가 고생한 세 번째 날입니다 😫 이제 끝났습니다.
Jay 씨, 정말 감사합니다 🙏
---
### Author:  [@pfaffman](https://meta.discourse.org/u/pfaffman)
#### Post date: [11월 20, 2025, 3:20오후 UTC](https://meta.discourse.org/t/overlayfs-to-overlay2-failed-on-fresh-installation-storage-driver/389126/4 "2025-11-20T15:20:26Z")
> [@iidbae](#):
>
> 내 말은, 현재 공식 담론(Discourse) 설치 과정에서 뭔가 잘못된 부분이 있다는 거야.
글쎄, 이건 도커(Docker)의 탓이지. 그들은 이를 수정할 거라고 계속 생각하지만, 내가 그걸 확인하기 전까지는 내 모든 설치에서 해당 파일이 생성되니까 걱정할 필요가 없어.
여기서 이에 대해 불만을 제기했어:
> **[Overlay2 not enabled by default with get.docker.com on Ubuntu LTS. 24.04](https://forums.docker.com/t/overlay2-not-enabled-by-default-with-get-docker-com-on-ubuntu-lts-24-04/150471)**
>
> Sometime in the past week or two, installing Docker on Linux does not enable overlay2, as it had for some years. Is this a feature or a bug? If you want to install Discourse (you’re using it now!), this is a problem. Here’s an example of someone...
---
### Author:  [@dschaper](https://meta.discourse.org/u/dschaper)
#### Post date: [11월 20, 2025, 9:05오후 UTC](https://meta.discourse.org/t/overlayfs-to-overlay2-failed-on-fresh-installation-storage-driver/389126/5 "2025-11-20T21:05:40Z")
> **[Storage drivers](https://docs.docker.com/engine/storage/drivers/)**
>
> Learn the technologies that support storage drivers.
Docker는 v29.0+에서 새로운 기본 스토리지 드라이버를 사용합니다
> Docker Engine 29.0 이상은 신규 설치 시 기본적으로 [containerd 이미지 스토어](https://docs.docker.com/engine/storage/containerd/)를 사용합니다. containerd 이미지 스토어는 이 페이지에 설명된 클래식 스토리지 드라이버 대신 스냅슈터(snapshotters)를 사용합니다. Docker Engine 29.0 이상을 새로 설치했거나 containerd 이미지 스토어로 마이그레이션을 완료한 경우, 이 페이지는 이미지 레이어가 작동하는 방식에 대한 배경 정보를 제공하지만 구현 세부 사항은 다릅니다. containerd 이미지 스토어에 대한 정보는 [containerd 이미지 스토어](https://docs.docker.com/engine/storage/containerd/)를 참고하십시오.
---
### Author:  [@featheredtoast](https://meta.discourse.org/u/featheredtoast)
#### Post date: [11월 21, 2025, 12:21오전 UTC](https://meta.discourse.org/t/overlayfs-to-overlay2-failed-on-fresh-installation-storage-driver/389126/6 "2025-11-21T00:21:47Z")
그러면 제가 이해한 바로는, `overlayfs`도 함께 찾아서 포함해야 한다는 거죠?
관련 PR은 여기 있습니다:
>
>
> new storage driver on by default, per:
> https://docs.docker.com/engine/storage/d…rivers/
>
> containerd image store seems to report as overlayfs, so we should allow for this string as well.
>
> Ref:
> https://meta.discourse.org/t/overlayfs-to-overlay2-failed-on-fresh-installation-storage-driver/389126
---
### Author:  [@pfaffman](https://meta.discourse.org/u/pfaffman)
#### Post date: [11월 21, 2025, 12:53오전 UTC](https://meta.discourse.org/t/overlayfs-to-overlay2-failed-on-fresh-installation-storage-driver/389126/7 "2025-11-21T00:53:10Z")
모르겠어요. 오버레이가 작동하는지 테스트해 보지 않았거든요. 어떤 시점에는 작동하지 않았고, 그래서 요구 사항으로 설정한 겁니다. 더 이상 요구 사항이 아니라는 사실은 생각하지 못했네요.
아.
> containerd 이미지 스토어가 overlayfs로 보고되는 것 같으니, 이 문자열도 허용해야 합니다.
---
### Author:  [@featheredtoast](https://meta.discourse.org/u/featheredtoast)
#### Post date: [11월 21, 2025, 2:54오전 UTC](https://meta.discourse.org/t/overlayfs-to-overlay2-failed-on-fresh-installation-storage-driver/389126/8 "2025-11-21T02:54:17Z")
네, 공유해 주신 게시물에 따르면 차이는 다음과 같습니다:
```plaintext
< Storage Driver: overlay2
< Backing Filesystem: xfs
< Supports d_type: true
< Using metacopy: false
< Native Overlay Diff: true
< userxattr: false
---
> Storage Driver: overlayfs
> driver-type: io.containerd.snapshotter.v1
```
개발용 머신에서 도커를 재설치/업데이트했는데 같은 문제가 발생하여, 이 방법이 실제로 문제를 해결하는 것임을 확인했습니다.
---
### Author:  [@system](https://meta.discourse.org/u/system)
#### Post date: [12월 21, 2025, 2:55오전 UTC](https://meta.discourse.org/t/overlayfs-to-overlay2-failed-on-fresh-installation-storage-driver/389126/9 "2025-12-21T02:55:06Z")
This topic was automatically closed 30 days after the last reply. New replies are no longer allowed.