From 5d9094adb0502bced3229df806fef67863b70359 Mon Sep 17 00:00:00 2001 From: Schallbert Date: Mon, 26 May 2025 16:11:47 +0000 Subject: [PATCH] Clarify customization's folder structure when using non-standard install like docker (#219) customizing: add backlink to install for variations install-with-docker: add example for customization Reviewed-on: https://gitea.com/gitea/docs/pulls/219 Co-authored-by: Schallbert Co-committed-by: Schallbert --- docs/administration/customizing-gitea.md | 4 ++-- docs/installation/with-docker.md | 2 ++ 2 files changed, 4 insertions(+), 2 deletions(-) diff --git a/docs/administration/customizing-gitea.md b/docs/administration/customizing-gitea.md index 74e2d18a..0f44372e 100644 --- a/docs/administration/customizing-gitea.md +++ b/docs/administration/customizing-gitea.md @@ -9,7 +9,7 @@ aliases: # Customizing Gitea Customizing Gitea is typically done using the `CustomPath` folder - by default this is -the `custom` folder from the working directory (WorkPath), but may be different if your build has +the `custom` folder from the working directory (WorkPath), but may be different if your [installation](../installation/installation.md) has set this differently. This is the central place to override configuration settings, templates, etc. You can check the `CustomPath` using `gitea help`. You can also find the path on the _Configuration_ tab in the _Site Administration_ page. You can override @@ -23,7 +23,7 @@ the Linux Filesystem Standard. Gitea will attempt to create required folders, in `custom/`. Distributions may provide a symlink for `custom` using `/etc/gitea/`. Application settings can be found in file `CustomConf` which is by default, -`$GITEA_CUSTOM/conf/app.ini` but may be different if your build has set this differently. +`$GITEA_CUSTOM/conf/app.ini` but may be different if your [installation](../installation/installation.md) has set this differently. Again `gitea help` will allow you review this variable and you can override it using the `--config` option on the `gitea` binary. diff --git a/docs/installation/with-docker.md b/docs/installation/with-docker.md index 3d672900..4452290f 100644 --- a/docs/installation/with-docker.md +++ b/docs/installation/with-docker.md @@ -266,6 +266,8 @@ files; for named volumes, this is done through another container or by direct ac `/var/lib/docker/volumes/gitea_gitea/_data`. The configuration file will be saved at `/data/gitea/conf/app.ini` after the installation. +Example: Analogous to the non-docker-installation customization linked above, you can create a `/public` folder within `/data/gitea` and place your custom `robots.txt` there which will then be served normally. + ## Upgrading :::warning