99 lines
2.9 KiB
Markdown
99 lines
2.9 KiB
Markdown
# Gitea Installer
|
|
|
|
Installs [Gitea](https://gitea.io) (formerly gogs) as a systemd service
|
|
|
|
## Linux Install Script
|
|
|
|
You can download and run the installer script:
|
|
|
|
```bash
|
|
wget -O install-gitea.bash https://git.coolaj86.com/coolaj86/gitea-installer.sh/raw/master/install.bash
|
|
bash install-gitea.bash
|
|
```
|
|
|
|
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 ''
|
|
|
|
# Make some other potentially useful directories for that user/group
|
|
sudo mkdir -p /opt/gitea/ /var/log/gitea
|
|
sudo chown -R gitea:gitea /opt/gitea/ /var/log/gitea
|
|
|
|
# Download and install gitea
|
|
sudo wget -O /opt/gitea/gitea https://dl.gitea.io/gitea/1.0.1/gitea-1.0.1-linux-amd64
|
|
sudo chmod +x /opt/gitea/gitea
|
|
|
|
# Download and install the gitea.service for systemd
|
|
sudo wget -O /etc/systemd/system/gitea.service https://git.coolaj86.com/coolaj86/gitea-installer.sh/raw/master/dist/etc/systemd/system/gitea.service
|
|
|
|
# Start gitea
|
|
sudo systemctl restart gitea
|
|
```
|
|
|
|
## 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/
|
|
|
|
## Customize Gitea
|
|
|
|
```
|
|
/opt/gitea/custom/conf/app.ini
|
|
|
|
https://github.com/go-gitea/gitea/tree/master/custom/conf/app.ini.sample
|
|
```
|
|
|
|
## Customize Gitea Theme
|
|
|
|
All overrides to the existing theme can be placed in the `custom/public` and `custom/templates` folders.
|
|
|
|
|
|
```
|
|
/opt/gitea/custom/public
|
|
/opt/gitea/custom/templates
|
|
|
|
/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
|
|
```
|
|
|
|
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/
|
|
|
|
|
|
**Note to self**:
|
|
|
|
All of my custom files
|
|
|
|
```
|
|
/opt/gitea/custom/
|
|
|-- conf
|
|
| `-- app.ini
|
|
|-- options
|
|
| `-- locale
|
|
| `-- locale_en-US.ini # changed app_desc
|
|
|-- public
|
|
| `-- img
|
|
| |-- coolaj86-logo.png
|
|
| |-- favicon.ico -> favicon.png
|
|
| |-- favicon.png
|
|
| |-- gitea-lg.png
|
|
| `-- gitea-sm.png
|
|
`-- templates
|
|
|-- base
|
|
| `-- head.tmpl # Added github login
|
|
`-- home.tmpl # changed welcome page
|
|
```
|
|
# Troubleshooting systemd
|
|
|
|
See [Troubleshooting systemd](https://git.coolaj86.com/coolaj86/service-installer.sh/src/master/README.md#troubleshooting-systemd) |