Update GITEA README

This commit is contained in:
whitney 2025-03-15 02:11:49 -07:00
parent f74d3faf98
commit e41ca2e67e

View File

@ -4,17 +4,25 @@ Followed instructions on Gitea page: https://docs.gitea.com/next/installation/in
### Steps ### Steps
1. Create a new user to own the gitea folder. 1. Create a new user to own the gitea folder.
`sudo groupadd gitea && sudo useradd giteauser && sudo usermod -a -G gitea giteauser && chown -r gitea:giteauser .` ```
sudo groupadd gitea && sudo useradd giteauser && sudo usermod -a -G gitea giteauser && chown -r gitea:giteauser .
```
2. Run via Docker Compose 2. Run via Docker Compose
`docker-compose up -d` ```
docker-compose up -d
```
3. Test postgresql 3. Test postgresql
`docker exec -it gitea_db bash` ```
`psql -h 127.0.0.1 -p 5432 -U olomana_readwrite -d gitea` docker exec -it gitea_db bash
psql -h 127.0.0.1 -p 5432 -U olomana_readwrite -d gitea
```
4. Go to xxx.xxx.xx.xxx:3000 and fill out initial config. Everything should match up to default value. 4. Go to xxx.xxx.xx.xxx:3000 and fill out initial config. Everything should match up to default value.
Some things that were weird: Some things that were weird:
- could not use any port that wasnt default postgresql (5432) - could not use any port that wasnt default postgresql (5432)
- had to make sure to specify database container by the right name. Removed custom name and used just "databasei". - had to make sure to specify database container by the right name. Removed custom name and used just "database".
Additionally, you must provision the first admin user in the initial config. Note that the first admin is set via env vars, by generating the password hash. Alternatively create your users by setting the env var that controls signups.
5. Provision new users 5. Provision new users
You can do that from the "Site Administration" view from the first admin user. You can do that from the "Site Administration" view from the first admin user.
6. Configure SSH 6. Configure SSH
@ -39,5 +47,10 @@ entryPoints:
Settings > SSH/GPG Keys > Manage SSH Keys Settings > SSH/GPG Keys > Manage SSH Keys
Now should also be able to clone with SSH. Now should also be able to clone with SSH.
### Running
```
docker compose down && docker compose build && docker compose up -d && docker logs -f gitea
```
### References ### References
`https://docs.gitea.com/next/administration/config-cheat-sheet` `https://docs.gitea.com/next/administration/config-cheat-sheet`