adding ssh keys for comfortable push/pull

created onAugust 29, 2025
With your ssh public key registered with Gitea, you can push and pull to and from Gitea without being asked for your password for every action. ...

renaming the default branch of a repo in Gitea

created onAugust 29, 2025
I was already tired for a while that the default repo name in git was master. So I took the opportunity when updating Gitea to rename the default branch of the corresponding git repos to main. ...

run Gitea behind a proxy

created onAugust 29, 2025
This has the advantage that I don’t have to remember the port on which Gitea is running and can just type https://idoru/gitea into my browser’s address bar. ...

run Gitea with TLS

created onAugust 29, 2025
You need two certificates: the certificate chain to the Root CA and the certificate for gitea. I’m running an own root CA in my LAN (mostly for fun and educational purpose) and issued a cert for gitea. ...

gitignore files

created onAugust 29, 2025
Can be added to repos that are created with Gitea. gitignore files go into <gitea-install-dir>/conf/gitignore. ...

custom label files

created onAugust 29, 2025
Label files with labels to categorize issues/tickets go into <gitea-install-dir>/conf/options. Gitea 1.19 introduced a pretty cool new label format. There is an example of a label file on the gitea GitHub page Advanced.yaml. At the time of writing the YAML example misses the three mandatory dashes ‘—’, that indicate the start of a new YAML document. ...

importing repos into Gitea

created onAugust 29, 2025
Repos that have been created outside gitea can be imported, or in Gitea speak adopted, and managed by Gitea. I’m using both terms import and adopt here. ...

issues and fixes

created onAugust 29, 2025
starting gitea with another user than defined in gitea.conf results in: ... routers/init.go:74:mustInitCtx() [F] code.gitea.io/gitea/modules/git.InitFull(ctx) failed: failed to set git global config diff.algorithm, err: exit status 255 - warning: unable to access '/home/rudolf/.config/git/gitconfig': Permission denied error: could not lock config file /home/rudolf/.config/git/gitconfig: Permission denied - warning: unable to access '/home/rudolf/.config/git/gitconfig': Permission denied error: could not lock config file /home/rudolf/.config/git/gitconfig: Permission denied the fix is to run unset GIT_CONFIG_GLOBAL before running gitea. ...