본문 바로가기
개발/git

gitea 서비스가 패키지 업데이트 후 시작 실패하는 증상 조치

by hyperhand 2026. 5. 21.

몇 년간 소스 관리용으로 라즈베리파이에 설치해서 잘 사용하던 gitea가 갑자기 서비스가 중단되는 현상이 발생했다. 다시 시작하려 해도 시작도 되지 않는다.

$ sudo systemctl status snap.gitea.web.service
x snap.gitea.web.service - Service for snap application gitea.web
     Loaded: loaded (/etc/systemd/system/snap.gitea.web.service; enabled; preset: enabled)
     Active: failed (Result: exit-code) since Thu 2026-05-21 13:10:16 KST; 724ms ago
   Duration: 955ms
    Process: 228085 ExecStart=/usr/bin/snap run gitea.web (code=exited, status=1/FAILURE)
   Main PID: 228085 (code=exited, status=1/FAILURE)
        CPU: 1.268s

May 21 13:10:16 raspberrypi systemd[1]: snap.gitea.web.service: Scheduled restart job, restart counter is at 5.
May 21 13:10:16 raspberrypi systemd[1]: Stopped snap.gitea.web.service - Service for snap application gitea.web.
May 21 13:10:16 raspberrypi systemd[1]: snap.gitea.web.service: Consumed 1.268s CPU time.
May 21 13:10:16 raspberrypi systemd[1]: snap.gitea.web.service: Start request repeated too quickly.
May 21 13:10:16 raspberrypi systemd[1]: snap.gitea.web.service: Failed with result 'exit-code'.
May 21 13:10:16 raspberrypi systemd[1]: Failed to start snap.gitea.web.service - Service for snap application gitea.web.

 

원인 파악을 위해 다음과 같이 로그를 확인했다.

$ sudo journalctl -u snap.gitea.web.service -n 50 --no-pager
...
May 21 13:10:14 raspberrypi gitea.web[228033]: 2026/05/21 13:10:14 routers/init.go:140:InitWebInstalled() [F] SQLite3 support is disabled, but it is used for database setting. Please get or build a Gitea release with SQLite3 support.
May 21 13:10:14 raspberrypi systemd[1]: snap.gitea.web.service: Main process exited, code=exited, status=1/FAILURE
May 21 13:10:14 raspberrypi systemd[1]: snap.gitea.web.service: Failed with result 'exit-code'.
May 21 13:10:14 raspberrypi systemd[1]: snap.gitea.web.service: Consumed 1.119s CPU time.
May 21 13:10:15 raspberrypi systemd[1]: snap.gitea.web.service: Scheduled restart job, restart counter is at 4.
May 21 13:10:15 raspberrypi systemd[1]: Stopped snap.gitea.web.service - Service for snap application gitea.web.
May 21 13:10:15 raspberrypi systemd[1]: snap.gitea.web.service: Consumed 1.119s CPU time.
May 21 13:10:15 raspberrypi systemd[1]: Started snap.gitea.web.service - Service for snap application gitea.web.
...
May 21 13:10:16 raspberrypi gitea.web[228085]: 2026/05/21 13:10:16 routers/init.go:140:InitWebInstalled() [F] SQLite3 support is disabled, but it is used for database setting. Please get or build a Gitea release with SQLite3 support.
May 21 13:10:16 raspberrypi systemd[1]: snap.gitea.web.service: Main process exited, code=exited, status=1/FAILURE
May 21 13:10:16 raspberrypi systemd[1]: snap.gitea.web.service: Failed with result 'exit-code'.
May 21 13:10:16 raspberrypi systemd[1]: snap.gitea.web.service: Consumed 1.268s CPU time.
May 21 13:10:16 raspberrypi systemd[1]: snap.gitea.web.service: Scheduled restart job, restart counter is at 5.
May 21 13:10:16 raspberrypi systemd[1]: Stopped snap.gitea.web.service - Service for snap application gitea.web.
May 21 13:10:16 raspberrypi systemd[1]: snap.gitea.web.service: Consumed 1.268s CPU time.
May 21 13:10:16 raspberrypi systemd[1]: snap.gitea.web.service: Start request repeated too quickly.
May 21 13:10:16 raspberrypi systemd[1]: snap.gitea.web.service: Failed with result 'exit-code'.
May 21 13:10:16 raspberrypi systemd[1]: Failed to start snap.gitea.web.service - Service for snap application gitea.web.

 

긴 로그 내용 중 "SQLite3 support is disabled" 라는 문구가 있었다. 무슨 이유에서인지 현재 버전(1.26.1)에서 sqlite3의 지원이 중단된 듯 보인다.

 

그래서, 잘 작동하던 버전으로 되돌리기 위해 아래와 같이 조치했다.

sudo snap revert gitea
gitea reverted to v1.26.0

 

이렇게 하면 직전 버전으로 다시 돌아가고 서비스를 다시 재시작하면 정상 작동하는 것을 확인할 수 있다.

sudo systemctl start snap.gitea.web.service
leekypi@raspberrypi:~ $ sudo systemctl status snap.gitea.web.service
* snap.gitea.web.service - Service for snap application gitea.web
     Loaded: loaded (/etc/systemd/system/snap.gitea.web.service; enabled; preset: enabled)
     Active: active (running) since Thu 2026-05-21 13:45:11 KST; 17s ago
   Main PID: 228427 (gitea)
      Tasks: 10 (limit: 8742)
        CPU: 1.922s
     CGroup: /system.slice/snap.gitea.web.service
             `-228427 /snap/gitea/7901/gitea web

May 21 13:45:12 raspberrypi gitea.web[228427]: 2026/05/21 13:45:12 cmd/web.go:205:serveInstalled() [W] Table system_setting Column version db default is , struct default is 1
May 21 13:45:12 raspberrypi gitea.web[228427]: 2026/05/21 13:45:12 routers/init.go:144:InitWebInstalled() [I] ORM engine initialization successful!
May 21 13:45:12 raspberrypi gitea.web[228427]: 2026/05/21 13:45:12 .../indexer/issues/indexer.go:78:InitIssueIndexer.1() [I] PID 228427: Initializing Issue Indexer: bleve
May 21 13:45:12 raspberrypi gitea.web[228427]: 2026/05/21 13:45:12 .../indexer/issues/indexer.go:155:InitIssueIndexer.2() [I] Issue Indexer Initialization took 1.974339ms
May 21 13:45:12 raspberrypi gitea.web[228427]: 2026/05/21 13:45:12 .../indexer/stats/indexer.go:41:populateRepoIndexer() [I] Populating the repo stats indexer with existing repositories
May 21 13:45:12 raspberrypi gitea.web[228427]: 2026/05/21 13:45:12 .../indexer/stats/indexer.go:87:populateRepoIndexer() [I] Done (re)populating the repo stats indexer with existing repositories
May 21 13:45:12 raspberrypi gitea.web[228427]: 2026/05/21 13:45:12 cmd/web.go:329:listen() [I] Listen: http://0.0.0.0:5274
May 21 13:45:12 raspberrypi gitea.web[228427]: 2026/05/21 13:45:12 cmd/web.go:333:listen() [I] AppURL(ROOT_URL): http://192.168.0.3:5274/
May 21 13:45:12 raspberrypi gitea.web[228427]: 2026/05/21 13:45:12 cmd/web.go:336:listen() [I] LFS server enabled
May 21 13:45:12 raspberrypi gitea.web[228427]: 2026/05/21 13:45:12 modules/graceful/server.go:52:NewServer() [I] Starting new Web server: tcp:0.0.0.0:5274 on PID: 228427

 

하지만, 그냥 이렇게 놔두면 나중에 다시 자동 업데이트로 버전업 될 수 있다. 그렇기에, 이슈가 해결될 때까지는 자동 업데이트가 되지 않도록 막아야 한다.

$ sudo snap refresh --hold gitea
General refreshes of "gitea" held indefinitely

 

나중에 이슈가 해결되면 다음과 같이 자동 업데이트를 허용하도록 한다.

sudo snap refresh --unhold gitea
sudo snap refresh gitea