APP_DATA_PATH and GITEA_WORK_DIR are not/badly documented #9714

New Issue

GiteaMirror · 2025-11-02T08:47:21-06:00

GiteaMirror commented

2025-11-02 08:47:21 -06:00

Originally created by @mqus on GitHub (Oct 20, 2022).

Feature Description

GITEA_WORK_DIR is referenced multiple times in the config cheat sheet and the example config, but is itself not contained at all in those resources.

APP_DATA_PATH is contained in the linked documentation parts, but has so little text, it is almost useless. I am missing information such as: which application data is put there? (logs, repos, database, git stuff, ssh stuff, config, ..?) If this is relative (which seems to be the default), what path is it relative to?

Also, what is the difference/relation between GITEA_WORK_DIR and APP_DATA_PATH? They seem to be pretty crucial configuration options.

Screenshots

No response

Originally created by @mqus on GitHub (Oct 20, 2022). ### Feature Description `GITEA_WORK_DIR` is referenced multiple times in the [config cheat sheet](https://docs.gitea.io/en-us/config-cheat-sheet/) and the [example config](https://github.com/go-gitea/gitea/blob/main/custom/conf/app.example.ini), but is itself not contained at all in those resources. `APP_DATA_PATH` is contained in the linked documentation parts, but has so little text, it is almost useless. I am missing information such as: which application data is put there? (logs, repos, database, git stuff, ssh stuff, config, ..?) If this is relative (which seems to be the default), what path is it relative to? Also, what is the difference/relation between `GITEA_WORK_DIR` and `APP_DATA_PATH`? They seem to be pretty crucial configuration options. ### Screenshots _No response_

GiteaMirror added the type/proposal type/docs labels 2025-11-02 08:47:21 -06:00

GiteaMirror closed this issue

2025-11-02 08:47:21 -06:00

GiteaMirror commented

2025-11-02 08:47:22 -06:00

@gscsnm commented on GitHub (Nov 1, 2022):

I have the same problm.
CustomPath & AppWorkPath & AppPath
what is the difference？

run gitea in docker.

@gscsnm commented on GitHub (Nov 1, 2022): I have the same problm. CustomPath & AppWorkPath & AppPath what is the difference？ run gitea in docker.

Sign in to join this conversation.

Branches Tags

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: github-starred/gitea#9714