Skip to main content

Code Repositories

iForge provides complete Git code hosting capabilities.

Repository Management

  • Create Repository: Supports public/private repositories, can set description and default branch
  • Import Repository: Import existing repositories from external Git URLs
  • Fork Repository: Any logged-in user can Fork public repositories to their own space
  • Mirror Sync: Configure automatic pull updates from external repositories
  • Repository Settings: Custom clone URL templates (HTTPS/SSH prefix)

Git Protocols

HTTP/HTTPS

git clone http://your-host:8081/owner/repo.git
git push origin main

All Git HTTP operations (clone, push, pull, fetch) use port 8081, shared with the API.

SSH

# Non-standard port
git clone ssh://git@your-host:2022/owner/repo.git

# Standard port 22 (automatically converts to SCP-like format)
git clone git@your-host:owner/repo.git

SSH keys are added on the user settings page and stored in the database (application-level SSH, not system sshd).

Port 22 Auto Conversion

When the SSH port is configured as 22, the clone URL automatically converts to SCP-like format (git@host:owner/repo.git), without the need for ssh:// prefix and port number. See SSH Keys for details.

Branch Management

  • Create, delete branches
  • Branch protection rules (mandatory code review, prohibit force push)
  • Branch comparison (diff view)
  • Branch-Task Association: Branches can be directly associated with tasks in project management

File Browsing

  • View code files online, supports syntax highlighting
  • Directory tree navigation
  • Commit history and diff comparison
  • Raw file download
  • Markdown file online rendering

Commit History

  • Complete commit history browsing
  • Commit details (changed files, diff comparison)
  • Reference #IssueNumber or #TASK-Number in commit messages for automatic association

Release Management

  • Create version releases (based on Tags)
  • Upload attachments (binary artifacts)
  • Release notes (Markdown rendering)

Wiki

Each repository can enable Wiki functionality for project documentation collaboration:

  • Markdown editing
  • Version history
  • Sidebar navigation

Code Quality

  • Integrated code quality analysis
  • Code coverage statistics
  • Quality report visualization