Skip to main content

Logo Gitea

About​

Gitea is a community managed lightweight code hosting solution written in Go.

Customizing Gitea​

Customize Gitea using the custom folder. This is the central place to override configuration settings, templates, etc.

On Cloudron, the custom data folder is located at /app/data/custom.

Gitea also supports various configuration customizations. Add customizations using the File Manager to edit the file /app/data/app.ini.

Restart the app after editing for changes to take effect.

LFS​

Gitea supports any s3-like storage as a backend for LFS and attachments (see Gitea Config Cheat Sheet). Add the following configuration and restart gitea from the dashboard:

INI
[server]
LFS_START_SERVER = true

[storage.my-storage]
STORAGE_TYPE = minio
SERVE_DIRECT = true
MINIO_ENDPOINT = s3.us-west-001.backblazeb2.com 
MINIO_ACCESS_KEY_ID = {secret-id}
MINIO_SECRET_ACCESS_KEY = {secret-key}
MINIO_BUCKET = my-bucket
MINIO_LOCATION = us-west-001
MINIO_USE_SSL = true

[lfs]
STORAGE_TYPE = my-storage

[attachment]
STORAGE_TYPE = my-storage
MAX_SIZE = 50

CLI​

The gitea CLI can be used as follows:

Bash
sudo -u git /home/git/gitea/gitea -c /run/gitea/app.ini  --help

For example, to change the root password:

Bash
sudo -u git /home/git/gitea/gitea -c /run/gitea/app.ini admin user change-password -u root -p changeme123

GPG​

The package sets GNUPGHOME environment variable to /app/data/gnupg . The gpg CLI tool uses this path and so does gitea to locate keys.