77 lines
4.1 KiB
Markdown
77 lines
4.1 KiB
Markdown
## Gitea install script for muliple instances 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)
|
|
|
|
> **Important:**
|
|
>
|
|
> There are rules to this one. Normally I don't make rules, but I've been pondering how to do this. So here goes:
|
|
>
|
|
> For each Gitea instance (everytime you run this script) the following rules apply:
|
|
>
|
|
> Each intance will have it's own user. i.e gitea1, gitea2 etc.\
|
|
> Each intance will have it's own local port. i.e 3001, 3002 etc.\
|
|
> Each instance will have it's own configuration file i.e giteainstance.app.ini\
|
|
> Each instance will have it's own service unit i.e you will end up with several systemctl restart gitea1 and systemctl restart gitea2 restart etc.\
|
|
> Each instance will share the same **Gitea Execuatable**. So if you update please make sure all owners of the other instances are notified.
|
|
|
|
### Logic
|
|
The first instance will be called:\
|
|
**gitea1** and the local port will be **3001** the database name will be **gitea1db** and the service to restart **gitea1.service**\
|
|
The second instance will be called:\
|
|
**gitea2** and the local port will be **3002** the database name will be **gitea2db** and the service to restart **gitea2.service**
|
|
|
|
I think you get the idea. I can only do so much checking regarding your current setup, but the script should be able to do the logic. Meaning if gitea1 allready exists it will choose gitea2 as the next instance. And since you ventured this far you should know how to fix things if they mess up.
|
|
|
|
### Download the script
|
|
```
|
|
git clone https://git.x-files.dk/ubuntu-web-application/gitea-multi-install.git
|
|
```
|
|
|
|
### Usage
|
|
cd gitea-multi-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-instance/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.
|