mirror of
https://github.com/tiennm99/composes.git
synced 2026-10-11 03:13:16 +00:00
57 lines
2.2 KiB
Markdown
57 lines
2.2 KiB
Markdown
# gitea
|
|
|
|
Self-hosted [Gitea](https://about.gitea.com/) backed by PostgreSQL.
|
|
|
|
## Services
|
|
|
|
| Service | Image | Internal port | Domain |
|
|
| --- | --- | --- | --- |
|
|
| `db` | `postgres:18-alpine` | 5432 | none |
|
|
| `gitea` | `gitea/gitea:28` | 3000 | `GITEA_ROOT_URL` |
|
|
|
|
In Coolify, give `gitea` a domain on port 3000 matching `GITEA_ROOT_URL`.
|
|
|
|
`gitea` waits for `db` to pass its health check, and checks `/api/healthz`
|
|
itself.
|
|
|
|
## Variables
|
|
|
|
| Variable | Feeds | Notes |
|
|
| --- | --- | --- |
|
|
| `POSTGRES_PASSWORD` | `db`, `gitea` | Defaults to `gitea`. |
|
|
| `GITEA_ROOT_URL` | Gitea `server.ROOT_URL` | Public URL, with trailing slash. Gitea builds clone URLs and redirects from it. |
|
|
| `GITEA_CLONE_TIMEOUT` | Gitea `git.timeout` `MIGRATE` and `MIRROR` | Seconds a mirror's first clone or a later fetch may run. Defaults to `3600`. |
|
|
|
|
## Choices
|
|
|
|
- **HTTPS only.** The proxy routes HTTP, not SSH, so Gitea's SSH server is
|
|
disabled and the UI offers HTTPS clone URLs only.
|
|
- **Registration disabled.** The instance is public, and open sign-up drew
|
|
spam accounts. Admins create users from the site administration page.
|
|
- **One-hour clone timeout.** Gitea's defaults (600 s to migrate, 300 s to
|
|
fetch) cut off multi-gigabyte repositories mid-clone, leaving empty mirrors
|
|
that still hold gigabytes of unreachable packfiles. A client that calls the
|
|
migrate API gets no response until the clone ends, so it must wait at least
|
|
this long.
|
|
- **`gitea/gitea:28`.** Gitea publishes major tags; the major pin takes
|
|
updates without a surprise major upgrade.
|
|
- **`postgres:18-alpine`**, the newest Postgres major; Gitea needs 12 or
|
|
later. The major stays pinned because a new major cannot read an existing
|
|
data directory without a dump and restore. From 18 the image keeps its data
|
|
in `/var/lib/postgresql/18/docker`, so `db-data` mounts at
|
|
`/var/lib/postgresql`, which lets a later major sit beside it on the same
|
|
volume.
|
|
|
|
## Usage
|
|
|
|
Complete Gitea's first-run setup at `GITEA_ROOT_URL`, creating the admin
|
|
account there since sign-up is closed, then create an access
|
|
token for any tool that mirrors into it.
|
|
|
|
## Storage
|
|
|
|
| Volume | Holds |
|
|
| --- | --- |
|
|
| `db-data` | PostgreSQL data, under `18/docker` |
|
|
| `gitea-data` | Repositories, Gitea config and state |
|