Add simple page on running Gitea in Docker locally

This commit is contained in:
James Skemp 2023-08-06 09:37:44 -05:00
parent 035b93bb6b
commit a7def019b6
2 changed files with 55 additions and 0 deletions

View File

@ -32,6 +32,7 @@
## Self-hosting
* [Gitea](hosting/gitea.md)
* [Updating Gitea](hosting/updating-gitea.md)
* [Hosting in Docker](hosting/gitea-docker.md)
## Related
* [Related links](related.md)

View File

@ -0,0 +1,54 @@
# Hosting Gitea in Docker
This is specific to a local/internal instance, running in Docker (24.0.5) on Ubuntu (22.04), with Docker Compose (2.20.2).
Latest Gitea at the time of writing is 1.20.1.
> Warning: This likely isn't the most secure.
1. Create a new user on the server for Git.
- `sudo adduser --system --shell /bin/bash --gecos 'Git Version Control' --group --disabled-password --home /home/git git`
- Make note of the UID and GID's returned.
2. `mkdir gitea && cd gitea`
3. `nano docker-compose.yml`
- Populate it with the contents below, setting the correct `USER_UID` and `USER_GID` values.
4. Start it up.
- `docker compose up -d`
5. Navigate to http://server-ip:port and create an account to verify.
To update Gitea config, you can update the local file. Assuming docker-compose.yml was saved to ~/docker/gitea:
`sudo vim docker/gitea/gitea/gitea/conf/app.ini`
The following may be beneficial to add:
- `repository` > `ENABLE_PUSH_CREATE_USER = true`
- `repository` > `ENABLE_PUSH_CREATE_ORG = true`
## docker-compose.yml
> Replace 117 and 122 UID and GID with the appropriate values. Replace `8070` and `2227` with the desired ports.
```yaml
version: "3"
networks:
gitea:
external: false
services:
server:
image: gitea/gitea:1.20.1
container_name: gitea
environment:
- USER_UID=117
- USER_GID=122
restart: always
networks:
- gitea
volumes:
- ./gitea:/data
- /etc/timezone:/etc/timezone:ro
- /etc/localtime:/etc/localtime:ro
ports:
- "8070:3000"
- "2227:22"
```