Gitea Server Template
=====================

A lightweight, self-hosted Git service. Gitea is a painless self-hosted Git
service similar to GitHub, GitLab, and Bitbucket.

Features:
- Git repository hosting
- Issue tracking
- Pull requests / code review
- Wiki
- CI/CD integration (with Gitea Actions or external runners)
- User and organization management
- Web-based interface

Configuration
-------------

Edit config/service.env to customize:

  CONTAINER_NAME  - Name of the Docker container (default: gitea)
  IMAGE_TAG       - Docker image tag (default: latest)
  HTTP_PORT       - Web interface port (default: 3000)
  SSH_PORT        - Git SSH port (default: 2222)

Ports
-----

  HTTP_PORT (default 3000) - Web interface and HTTP Git operations
  SSH_PORT (default 2222)  - SSH Git operations

First-Time Setup
----------------

After installation, access Gitea at http://your-server:HTTP_PORT to complete
the initial configuration wizard. You'll need to set:

  - Database type (SQLite3 is recommended for small installations)
  - Site title and base URL
  - Administrator account

Data Storage
------------

All data is stored in a Docker volume named ${CONTAINER_NAME}_data which
includes:
  - Git repositories
  - Database (if using SQLite)
  - User uploads and attachments
  - Configuration files

Backup
------

Use the backup.sh script to create backups of all Gitea data. The backup
includes repositories, database, and configuration.

SSH Clone URLs
--------------

To clone via SSH, users should use:
  git clone ssh://git@your-server:SSH_PORT/username/repo.git

Or configure SSH config for easier access.

More Information
----------------

Gitea documentation: https://docs.gitea.io/
Docker image: https://hub.docker.com/r/gitea/gitea