Files
dropshell-templates/gitea-server/README.txt
j 245837a872
All checks were successful
Test and Publish Templates / test-and-publish (push) Successful in 47s
Add 15 and update 3 files
2025-12-17 18:25:24 +13:00

71 lines
1.7 KiB
Plaintext

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