62 lines
3.0 KiB
Markdown
62 lines
3.0 KiB
Markdown
## 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\]](https://git.x-files.dk/ubuntu-web-server/nginx-install)
|
|
and MariaDB can be install from
|
|
[\[Here\]](https://git.x-files.dk/ubuntu-database-server/mariadb-install)
|
|
|
|
> **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\]](https://git.x-files.dk/ubuntu-web-application/gitea-multi-install)
|
|
|
|
### 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\]](https://git.x-files.dk/ubuntu-web-server/nginx-install/src/branch/main/cfg-apps/gitea.443.conf). 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://<i></i>git.something.xyz and fill out the mandatory fields marked with green.
|
|
<p align="center" width="100%">
|
|
<img src="https://git.x-files.dk/assets/gitea-configuration.png" alt="Gitea Configuration"/>
|
|
</p>
|
|
|
|
### 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\]](https://git.x-files.dk/ubuntu-web-server/nginx-install/src/branch/main/cfg/nginx.conf)
|
|
and also the default "sites-enabled" Nginx configurarion I use
|
|
[\[Here\]](https://git.x-files.dk/ubuntu-web-server/nginx-install/src/branch/main/cfg/default)
|
|
when you start troubleshooting.
|
|
|
|
### More guides
|
|
More guides can be found on [\[wiki.x-files.dk\]](https://wiki.x-files.dk)
|
|
|
|
### Last tested
|
|
October 10th 2024 on Ubuntu 24.04.
|