2017-10-25 23:07:47 +00:00
# Gitea Installer
2018-02-27 16:22:32 +00:00
Installs [Gitea ](https://gitea.io ) (formerly gogs) as a systemd service
2017-10-25 23:07:47 +00:00
2018-08-08 01:02:04 +00:00
# Easy Install (Linux)
2017-10-25 23:07:47 +00:00
2017-10-28 00:13:57 +00:00
You can download and run the installer script:
2017-10-25 23:07:47 +00:00
```bash
2017-11-10 17:45:35 +00:00
wget -O install-gitea.bash https://git.coolaj86.com/coolaj86/gitea-installer.sh/raw/master/install.bash
2017-10-28 00:13:57 +00:00
bash install-gitea.bash
```
2018-08-08 01:02:04 +00:00
# Screencast
< a href = "https://www.youtube.com/watch?v=dTvTBlzKqgg" target = "_blank" > < img src = "https://i.imgur.com/9x8iCUO.png" alt = "how to install Gitea" title = "Gitea Screencast" / > < / a >
# Manual Install
2017-10-28 00:13:57 +00:00
Or manually install by reading these instructions and following along:
```bash
# Create a 'gitea' user and group with the home /opt/gitea, no password (because it's a system user) and no GECOS
sudo adduser gitea --home /opt/gitea --disabled-password --gecos ''
2017-10-25 23:07:47 +00:00
# Make some other potentially useful directories for that user/group
2017-10-25 23:33:34 +00:00
sudo mkdir -p /opt/gitea/ /var/log/gitea
sudo chown -R gitea:gitea /opt/gitea/ /var/log/gitea
2017-10-25 23:07:47 +00:00
# Download and install gitea
sudo wget -O /opt/gitea/gitea https://dl.gitea.io/gitea/1.0.1/gitea-1.0.1-linux-amd64
2017-10-28 00:13:57 +00:00
sudo chmod +x /opt/gitea/gitea
2017-10-25 23:07:47 +00:00
# Download and install the gitea.service for systemd
2017-11-10 17:49:50 +00:00
sudo wget -O /etc/systemd/system/gitea.service https://git.coolaj86.com/coolaj86/gitea-installer.sh/raw/master/dist/etc/systemd/system/gitea.service
2017-10-25 23:07:47 +00:00
# Start gitea
sudo systemctl restart gitea
```
2017-10-28 05:27:16 +00:00
## Gitea Web Setup (post install)
Once you've gitea installed and running you must choose
which database to use, certain gitea paths, an admin user, etc.
> http://localhost:3000/
2018-03-26 06:32:53 +00:00
## Customize Gitea
```
/opt/gitea/custom/conf/app.ini
https://github.com/go-gitea/gitea/tree/master/custom/conf/app.ini.sample
```
2018-08-20 14:58:54 +00:00
Once a reverse proxy is set up you can change the `HTTP_ADDR` from the default (world accessible) to localhost-only.
```
HTTP_ADDR = localhost
```
2018-03-26 06:08:55 +00:00
## Customize Gitea Theme
All overrides to the existing theme can be placed in the `custom/public` and `custom/templates` folders.
2018-03-27 06:12:03 +00:00
* Change Logo
* Change Landing Page
* Google Analytics
2018-03-26 06:08:55 +00:00
```
/opt/gitea/custom/public
/opt/gitea/custom/templates
2018-03-26 06:32:53 +00:00
/opt/gitea/custom/public/img/favicon.png # 16x16 logo in tab
/opt/gitea/custom/public/img/gitea-sm.png # 120x120 logo on all pages
/opt/gitea/custom/public/img/gitea-sm.png # 880x880 logo on landing page
/opt/gitea/custom/templates/home.tmpl # The landing page
2018-08-20 15:24:38 +00:00
/opt/gitea/custom/templates/base/head.tmpl # Google Analytics, Login with Github
2018-03-26 06:08:55 +00:00
```
2018-08-20 15:24:38 +00:00
* [Login with Github ](https://git.coolaj86.com/coolaj86/gitea-installer.sh/src/tag/v1.0.0/custom/templates/base/head.tmpl#L277 )
2018-03-26 06:08:55 +00:00
For many items, such as the logo, you can simply right-click "inspect" to discover the location. For example, the small logo is `/img/gitea-sm.png` or `/opt/gitea/custom/public/img/gitea-sm.png` .
You can find more information about customization and templates in the docs and on github:
* https://docs.gitea.io/en-us/customizing-gitea/
* https://github.com/go-gitea/gitea/tree/master/templates/
2017-11-14 14:49:16 +00:00
# Troubleshooting systemd
2017-10-25 23:07:47 +00:00
2017-11-14 14:49:16 +00:00
See [Troubleshooting systemd ](https://git.coolaj86.com/coolaj86/service-installer.sh/src/master/README.md#troubleshooting-systemd )
