📝 update README.md 📝

- Refresh README content with latest project changes

README.md
This commit is contained in:
2026-05-31 14:46:46 -04:00
parent 0abc43bffc
commit 185f264caf
+35 -73
View File
@@ -1,117 +1,79 @@
# gitea
## 👋 Welcome to gitea 🚀
An all-in-one Alpine-based Docker image that bundles **Gitea** (self-hosted Git service), **Docker-in-Docker** (dockerd), and **act_runner** (Gitea Actions CI runner) into a single container. Designed for teams that want a complete self-hosted Git + CI/CD stack without orchestrating multiple containers. Gitea is pre-configured with Actions enabled, SSH access, LFS, and five act_runner worker instances that register automatically on first boot.
gitea README
---
## 🐳 Docker
### Pull and run
## Install my system scripts
```shell
sudo bash -c "$(curl -q -LSsf "https://github.com/systemmgr/installer/raw/main/install.sh")"
sudo systemmgr --config && sudo systemmgr install scripts
```
## Automatic install/update
```shell
dockermgr update gitea
```
## Install and run container
```shell
dockerHome="/var/lib/srv/$USER/docker/casjaysdevdocker/gitea/gitea/latest/volumes"
mkdir -p "/var/lib/srv/$USER/docker/gitea/volumes"
git clone "https://github.com/dockermgr/gitea" "$HOME/.local/share/CasjaysDev/dockermgr/gitea"
cp -Rfva "$HOME/.local/share/CasjaysDev/dockermgr/gitea/volumes/." "$dockerHome/"
docker run -d \
--restart always \
--privileged \
--name casjaysdevdocker-gitea-latest \
--hostname gitea \
-e TZ=${TIMEZONE:-America/New_York} \
-v /var/lib/srv/$USER/docker/casjaysdevdocker/gitea/data:/data:z \
-v /var/lib/srv/$USER/docker/casjaysdevdocker/gitea/config:/config:z \
-v "$dockerHome/data:/data:z" \
-v "$dockerHome/config:/config:z" \
-p 80:80 \
-p 7833:7833 \
-p 2375:2375 \
-p 44015:44015 \
casjaysdevdocker/gitea:latest
```
> **Note:** `--privileged` is required — the container runs a full Docker daemon (DinD) and needs cgroup v2 access.
### Ports
| Port | Protocol | Service | Description |
|------|----------|---------|-------------|
| `80` | TCP | Gitea | Web UI and HTTP clone |
| `7833` | TCP | sshd | Git SSH access (`git clone git@host:user/repo`) |
| `2375` | TCP | dockerd | Docker daemon (plain HTTP — bind to localhost or a trusted network only) |
| `44015` | TCP | act_runner | Actions artifact/cache server |
### Volumes
| Path | Description |
|------|-------------|
| `/config` | Gitea config, SSH host keys, act_runner registration state |
| `/data` | Gitea repositories, LFS objects, SQLite database, Docker layer cache |
### Environment variables
| Variable | Default | Description |
|----------|---------|-------------|
| `TZ` | `America/New_York` | Container timezone |
| `SERVER_ADDRESS` | `http://localhost` | Gitea URL used by act_runner for self-registration |
| `SERVER_TOKEN` | *(auto-generated)* | act_runner registration token — generated from Gitea on first boot if not set |
| `RUNNER_LABELS` | *(runner default)* | Comma-separated labels applied to all registered runners |
| `RUNNERS_START` | `5` | Number of act_runner worker instances to start |
| `RUNNERS_LOG_DIR` | `/var/log/act_runner` | Directory for per-runner log files |
### docker-compose
## via docker-compose
```yaml
version: "2"
services:
gitea:
image: casjaysdevdocker/gitea:latest
ProjectName:
image: casjaysdevdocker/gitea
container_name: casjaysdevdocker-gitea
restart: always
privileged: true
hostname: gitea
environment:
- TZ=America/New_York
- RUNNERS_START=5
- HOSTNAME=gitea
volumes:
- /var/lib/srv/$USER/docker/casjaysdevdocker/gitea/data:/data:z
- /var/lib/srv/$USER/docker/casjaysdevdocker/gitea/config:/config:z
- "/var/lib/srv/$USER/docker/casjaysdevdocker/gitea/gitea/latest/volumes/data:/data:z"
- "/var/lib/srv/$USER/docker/casjaysdevdocker/gitea/gitea/latest/volumes/config:/config:z"
ports:
- 80:80
- 7833:7833
- 2375:2375
- 44015:44015
restart: always
```
### Automatic install/update via dockermgr
## Get source files
```shell
dockermgr update gitea
dockermgr download src casjaysdevdocker/gitea
```
---
## 🛠️ Development
### Get source files
OR
```shell
git clone "https://github.com/casjaysdevdocker/gitea" "$HOME/Projects/github/casjaysdevdocker/gitea"
```
### 🐳 Docker build
The image builds for `linux/amd64` and `linux/arm64` via BuildX. Gitea and act_runner binaries are downloaded from GitHub/Gitea APIs at build time.
## Build container
```shell
cd "$HOME/Projects/github/casjaysdevdocker/gitea"
buildx
```
Image tags pushed: `casjaysdevdocker/gitea:latest` and `casjaysdevdocker/gitea:YYMM` (date tag).
---
## 👤 Authors
## Authors
🤖 casjay: [Github](https://github.com/casjay) 🤖
⛵ casjaysdevdocker: [Github](https://github.com/casjaysdevdocker) [Docker](https://hub.docker.com/u/casjaysdevdocker) ⛵
---
## 📄 License
MIT — see [LICENSE.md](LICENSE.md)