Skip to content

Gitea App

About

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

Customizing Gitea

Customizing Gitea is typically done 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. To add customizations, use the File Manager and edit the file named /app/data/app.ini.

After editing, restart the app for the 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 restarted gitea from the dashboard:

[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:

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

For example, to change the root password:

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