34 lines
No EOL
2 KiB
Markdown
34 lines
No EOL
2 KiB
Markdown
# git-server
|
|
|
|
The pieces that make up the git.starcat.systems Forgejo server.
|
|
|
|
## Contents
|
|
- `forgejo`:
|
|
- `app_ini` > `app.ini`: the Forgejo configuration file
|
|
- `custom`: customizations/tweaks made to Forgejo's appearance
|
|
- `caddy`:
|
|
- `Caddyfile`: the Caddy server configuration (reverse proxies Forgejo)
|
|
|
|
## Repo Mirrors
|
|
Repo contents are automatically pushed to the following mirrors:
|
|
|
|
[](https://git.starcat.systems/starcat-infra/git-server)
|
|
|
|
[](https://git.sr.ht/~starcatsys/git-server)
|
|
|
|
[](https://gitlab.com/starcatsys-mirror/starcat-infra/git-server)
|
|
|
|
⚠️ **These mirrors are not routinely monitored.** All issues and pull requests should be directed to the [main forge](https://git.starcat.systems/starcat-infra/git-server).
|
|
|
|
*[Why do we mirror some repos?](https://about.starcat.systems/handbook/infrastructure/code/mirroring/)*
|
|
|
|
## Making changes to Forgejo
|
|
1. Stop Forgejo: `sudo systemctl stop forgejo.service`
|
|
2. Upload new images/files (SFTP is probably easiest)
|
|
3. Chdir to the destination: `cd /var/lib/forgejo/custom/public/assets/img`
|
|
4. Change file permissions: `chown git:git apple-touch-icon.png favicon.png favicon.svg logo.png logo.svg`
|
|
5. Start Forgejo: `sudo systemctl start forgejo.service`
|
|
6. Wait for Forgejo to start, then refresh the site and make sure that changes flow through. You may have to give it a bit and/or clear your cache.
|
|
|
|
## Licensing Note
|
|
The changes and customizations to configurations, projects, and files in this repo are released under the MIT license. Other files, including those from Forgejo/Codeberg, Caddy, and images/logos may be released under different licenses. |