Gitea install script for a single instance of Gitea for Ubuntu 22.04 and 24.04 server.

Prerequisites

Ubuntu 22.04 or higher with Nginx and MariaDB. Nginx can be installed from [Here] and MariaDB can be install from [Here]

Note

If you in the future plan to install a second or third instance of Gitea I would recomend using the Gitea multiple instance script from [Here]

Download the script

git clone https://git.x-files.dk/ubuntu-web-application/gitea-install.git

Usage

cd gitea-install
sudo ./giteainstall [-n] <domain name> [-p] <gitea database password>

Example

sudo ./giteainstall -n git.something.xyz -p giteadatabasepwd

This will create a Gitea site running on port 80 with the domain name you chose under the installation. Don't worry though this can easily be fixed by modifying the Nginx configuration later. If you need an example on how to configure Nginx to run this on port 443 I an example [Here]. Also make sure that you correct the /etc/gitea/app.ini to reflect the changes as well i.e change http to https in the app.ini file and then restart Nginx and the Gitea instance.

Configuration

Once the script is done browse to http://git.something.xyz and fill out the mandatory fields marked with green.

Post install

This is needed in order to change a few configurations in app.ini which is first created when you are done with the setup screen.

cd gitea-install
sudo ./postinstall

Custom layout

Gitea takes the favicon in form of a svg file and a png file as fallback for browsers that does not support it. A custom logo can also be used. For all 3 files goes the following. They need to be placed in the folowing directory:
/var/lib/gitea/custom/public/assets/img/

Gitea can also serve a splash page instead of the build in one you will need to create a home.tmpl and place it in the following directory:
/var/lib/gitea/custom/templates/

Troubleshooting

Most issues will probably be caused by the fact that we all set up and configure Nginx diffrently. If you encounter problems I would suggest you look at the Nginx configuration I use [Here] and also the default "sites-enabled" Nginx configurarion I use [Here] when you start troubleshooting.

More guides

More guides can be found on [wiki.x-files.dk]

Last tested

October 10th 2024 on Ubuntu 24.04.