How to install custom themes

  1. Locate your gitea install working directory. The default for a linux service is WorkingDirectory=/var/lib/gitea/

  2. Under the $GITEA_WORK_DIR/custom directory create new folders public/css

  3. Upload your theme’s .css file in to this css directory

  4. Edit your app.ini. The default location is /etc/gitea/app.ini

  5. In the [ui] section add the THEMES variable. Add both of these if they are missing. Include all themes, starting with the default ones.

EXAMPLE: THEMES = gitea,arc-green,arc-blue

  1. Restart gitea: sudo service gitea restart

  2. Log in to your instance web interface

  3. Click on your user icon in the upper right corner

  4. Go Settings > Account tab > Select default theme section

Your new theme should be selectable in the dropdown menu. Hit Update Theme button to test. If it works you could optionally set this to the default theme for the instance using the app.ini file.


DEFAULT_THEME   = arc-blue
THEMES          = gitea,arc-green,arc-blue
1 Like

Thanks, This is exactly what I needed

1 Like