Skip to content
This repository was archived by the owner on Dec 2, 2017. It is now read-only.

Add GITEA_CUSTOM configuration in customization section #111

Merged
merged 3 commits into from
Apr 12, 2017
Merged

Add GITEA_CUSTOM configuration in customization section #111

Changes from 1 commit
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
b077702
Add GITEA_CUSTOM configuration in customization section
blankoworld Apr 6, 2017
cfb905a
Add new section about Gitea specific environment variables
blankoworld Apr 11, 2017
8402f85
Revert "Add GITEA_CUSTOM configuration in customization section"
blankoworld Apr 11, 2017
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 8 additions & 0 deletions content/doc/advanced/customizing-gitea.en-us.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -17,6 +17,14 @@ menu:

The main way to customize Gitea is by using the `custom` folder. This is the central place to override and configure features.

Use `GITEA_CUSTOM` to define another folder instead. For example:

```
GITEA_CUSTOM=/srv/gitea/mycustom ./gitea web
```

**Note** that by default Gitea will use the `custom` folder in the current working directory.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm afraid at the moment it'll be the custom folder in the directory containing the gitea binary unless GITEA_WORK_DIR env is set, in which case that's the directory used to resolve relative paths like custom/

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

You're right, I didn't be aware that GITEA_WORK_DIR variable exists.
That's why it should be better to create a specific subsection in this page to explain how GITEA_WORK_DIR and GITEA_CUSTOM works.
Or, in another case: create a specific page to list all available environment variable for GITEA?
What's your opinion about that?

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes please add a section about env variables


## Customizing /robots.txt

To make Gitea serve your own `/robots.txt` (by default, an empty 404 status is served), simply create a file called `robots.txt` in the `custom` folder with the [expected contents](http://www.robotstxt.org/). **Note** that you have to restart Gitea for it to notice the new `robots.txt`.
Expand Down