ForgejoGitLFS Team Setup & Clone Repo Tutorial

Step 1 — Setup Forgejo on WineJS

We use an automated script winejs_install_forgejogitlfs_opengraph.sh to provision Forgejo on the WineJS platform with Git LFS support and full integration:

# winejs_install_forgejogitlfs_opengraph.sh
# - Verifies WineJS platform at /opt/winejs
# - Creates docker network (winejs-net)
# - Downloads & configures Forgejo with Git LFS support
# - Sets up LFS path mapping server for large file handling
# - Creates shared volumes system (backups, imports, ci-cd)
# - Sets up auto-heal monitor and PM2 persistence
# - Injects OpenGraph meta tags for GitHub-style social sharing
# - Adds Repository Info button with JSON metadata extraction
# - Adds VsCodeServer fast-repo button
# - Configures webhook endpoints for automation
# ✅ Makes Forgejo accessible at https://your-domain.com/forgejo/

Git-LFS allows you to upload and store files more than 50mb, with extra filetype-specific monitoring

After running the installer, Forgejo is ready:

# Forgejo installation takes ~2-3 minutes to complete 
# Open https://your-domain.com/forgejo/ in the browser

The first time you start the app, you need to:

The installer creates an admin username & password automatically (winejs-admin)
Log in to the web UI with provided credentials
Create your first user profile (e.g., your-username)
Create your first repository (e.g., your-reponame)
Generate your first personal access token in Settings → Applications → Generate New Token or via (e.g., winejs-cli)
Set token permissions to [repository read/write] and copy the token (e.g., 1c9ca278c04f1713f3ff29ac03f81179a11acf85)

Step 2 — Clone Repo Automaticly - Script Generator

Auth token is required for private repos to clone.

Forgejo URL Username Personal Access Token

VSCode Online (bash) Script

Visual Studio 2022 (PowerShell) Script

Step 3 — Adding Collaborators

New team members create their own Forgejo accounts at https://wine.example.com/forgejo
As project manager, go to your repo → Settings → Collaboration
Search for their username and add them as collaborators with Write access
Each collaborator generates their own personal access token for Git operations

Step 4 — Setup Team Access

Forgejo supports multiple users on a repo without sharing accounts:

Each team member creates their own Forgejo account.
The repo owner/admin adds them as a collaborator on the your-reponame repo:
- Go to repo → Settings → Collaborators & Teams → Add Collaborator
- Set permission level:
  - Read → pull only
  - Write → pull & push
Each user generates their own personal access token.

Each dev clones using their own token:

git clone https://[email protected]/forgejo/USERNAME/REPO.git

✅ Pros:

Audit trail preserved (each commit shows the correct author).
Tokens are separate, so revoking one token doesn’t affect the team.
Works well with branch/PR workflows.

✅ Best practice for a game dev team:

Create separate accounts for each dev.
Use Write access for everyone who needs to push.
Use feature branches + PRs to avoid conflicts.
Use tokens for authentication — no passwords shared.

Step 5 — Setup VSCode and Visual Studio 2022

Your project enables you to utilize two powerful text editors:

VSCodeServer Online [Install on WineJS] — accessible via https://wine.example.com/vscode. You need to set this up for cloud-based coding.
Visual Studio 2022 [Download Windows/Macos/Linux] — installed on Windows 10 for game development and compilation.

Both editors can be used simultaneously for writing code. However, the game compilation happens in Visual Studio 2022 or with 'cmake' on VSCode.

6 — Enable Git LFS on Developer Machines

To manage large binary files in video game projects (like UE3 assets), Git LFS should be initialized on every developer machine:

Git LFS Bash Script (Linux / macOS)

#!/bin/bash
# =========================================================
# engine_gitlfs.sh
# Unified Git LFS tracking for multiple game engines
# Ensures LFS always downloads files (--no-skip-smudge)
# Interactive selection if engine not provided
# =========================================================
# Usage: ./engine_gitlfs.sh [engine] <path-to-repo> [push]
# Engines supported: ue3 | goldsrc | source | idtech3 | idtech4 | cryengine1 | thiefdark | sithengine
# Optional third argument "push" will push commits to origin.

set -euo pipefail

ENGINE="${1:-}"
REPO_PATH="${2:-}"
DO_PUSH="${3:-}"

# ------------------ Supported engines ------------------
SUPPORTED_ENGINES=(ue3 goldsrc source idtech3 idtech4 cryengine1 thiefdark sithengine)

# ------------------ Interactive engine selection ------------------
if [[ -z "$ENGINE" ]]; then
echo "Please select a game engine to track with Git LFS:"
    for i in "${!SUPPORTED_ENGINES[@]}"; do
        echo " $((i+1)). ${SUPPORTED_ENGINES[$i]}"
    done
    read -rp "Enter number (1-${#SUPPORTED_ENGINES[@]}): " choice
    if ! [[ "$choice" =~ ^[0-9]+$ ]] || (( choice < 1 || choice> ${#SUPPORTED_ENGINES[@]} )); then
        echo "❌ Invalid selection."
        exit 1
    fi
    ENGINE="${SUPPORTED_ENGINES[$((choice-1))]}"
    echo "✅ Selected engine: $ENGINE"
fi

# ----------------------- Dependencies ------------------------
if ! command -v git >/dev/null 2>&1; then
    echo "❌ git not installed."
    exit 1
fi

if ! command -v git-lfs >/dev/null 2>&1; then
    echo "📦 Installing Git LFS..."
    sudo apt-get update -q
    sudo apt-get install -y git-lfs
fi

echo "🔧 Initializing Git LFS..."
git lfs install --force || true

# ------------------ Define engine-specific patterns ------------------
declare -A ENGINE_PATTERNS

# Unreal Engine 3
ENGINE_PATTERNS[ue3]="*.ico *.upk *.umap *.psa *.psk *.abs *.fxa *.fbx *.png *.psd *.wav *.mp4 \
*.bik *.tga *.bmp *.dds *.jpg *.jpeg *.ogg *.mp3 *.usx *.utx *.uax *.ukx *.unr *.uc *.u \
*.swf *.bin *.pak *.iso *.zip *.rar *.dll *.lib *.pdb *.exe *.sln *.vcproj *.vcxproj *.vcxitems \
*.filters *.sdf *.log *.t3d *.udk *.chtml *.max *.3ds *.mb *.ma *.blend *.ztl *.ztb *.tbx *.mtl *.obj *.stl \
*.bgeo *.abc *.ply *.gltf *.glb *.igs *.step *.stp *.x3d *.bsp *.vox *.tiff *.tif *.exr *.hdr *.pfm \
*.raw *.ies *.sbsar *.sbs *.sppr *.tx *.xcf *.mat *.cg *.cgfx *.sma *.smi *.ptx *.bvh *.c3d *.anim \
*.skel *.rig *.mc *.mcx *.phy *.udk *.ukx *.uax *.utx *.usx *.fxa *.fxp *.bik *.swf *.gtl *.gma *.pak \
*.pakchunk* *.pak.info *.umx *.uplugin *.uproject *.uasset *.uexp *.ubulk *.wav *.mp3 *.ogg *.flac *.m4a \
*.aac *.ac3 *.mov *.avi *.wmv *.flv *.mkv *.m4v *.mxf *.r3d *.7z *.tar *.gz *.lz4 *.lzma *.xz *.cab \
*.msi *.vcxproj.user *.vsconfig *.props *.targets *.filters *.hlsl *.glsl *.fx *.fxc *.bat *.sh *.cmd \
*.patch *.diff *.cmake *.mak *.vssettings *.code-workspace *.vscode/*.json"
ENGINE_PATTERNS[ue3]+=" *.idea *.iml *.ipr *.iws CMakeLists.txt *.cmake"

# GoldSrc / Half-Life 1
ENGINE_PATTERNS[goldsrc]="*.wad *.bsp *.mdl *.spr *.wav *.mp3 *.txt *.cfg *.exe *.dll *.zip *.rar \
*.sln *.vcxproj *.filters *.user *.code-workspace *.vscode/*.json"
ENGINE_PATTERNS[goldsrc]+=" *.idea *.iml *.ipr *.iws CMakeLists.txt *.cmake"

# Source Engine / Hammer
ENGINE_PATTERNS[source]="*.vmf *.vmt *.vtf *.mdl *.wav *.mp3 *.txt *.cfg *.exe *.dll *.zip *.rar \
*.sln *.vcxproj *.filters *.user *.code-workspace *.vscode/*.json"
ENGINE_PATTERNS[source]+=" *.idea *.iml *.ipr *.iws CMakeLists.txt *.cmake"

# idTech3
ENGINE_PATTERNS[idtech3]="*.pk3 *.bsp *.shader *.tga *.jpg *.png *.wav *.mp3 *.cfg *.script *.pak \
*.sln *.vcxproj *.filters *.user *.code-workspace *.vscode/*.json"
ENGINE_PATTERNS[idtech3]+=" *.idea *.iml *.ipr *.iws CMakeLists.txt *.cmake"

# idTech4
ENGINE_PATTERNS[idtech4]="*.pk4 *.map *.tga *.jpg *.png *.shader *.wav *.mp3 *.cfg *.script *.pak \
*.sln *.vcxproj *.filters *.user *.code-workspace *.vscode/*.json"
ENGINE_PATTERNS[idtech4]+=" *.idea *.iml *.ipr *.iws CMakeLists.txt *.cmake"

# CryEngine 1 / FarCry 1
ENGINE_PATTERNS[cryengine1]="*.tga *.dds *.mtl *.xml *.cgf *.chr *.skin *.anm *.caf *.wav *.ogg *.mp3 \
*.lua *.cfg *.pak *.zip *.7z *.log *.dll *.so *.exe *.sln *.vcxproj *.filters *.user *.code-workspace \
*.vscode/*.json"
ENGINE_PATTERNS[cryengine1]+=" *.idea *.iml *.ipr *.iws CMakeLists.txt *.cmake"

# Thief 1-2 Dark Engine
ENGINE_PATTERNS[thiefdark]="*.mis *.gam *.bin *.crf *.cam *.pkt *.wav *.voc *.tga *.pcx *.pal *.mat *.mot *.cal
\
*.vdb *.fnm *.bin *.ms *.h *.hxz *.hx *.hk *.eq *.shock *.key *.txt *.cfg *.exe *.dll *.zip *.rar \
*.sln *.vcxproj *.filters *.user *.code-workspace *.vscode/*.json"
ENGINE_PATTERNS[thiefdark]+=" *.idea *.iml *.ipr *.iws CMakeLists.txt *.cmake"

# Jedi Knight: Dark Forces 2 (Sith Engine)
ENGINE_PATTERNS[sithengine]="*.3do *.anm *.bm *.cmp *.cfg *.dac *.dad *.dao *.mat *.md *.md3 *.pal *.pup \
*.sfx *.tga *.txt *.vox *.wav *.git *.key *.mat *.snd *.snd *.voc *.wal *.wed *.zkn *.zkp *.zkl \
*.exe *.dll *.zip *.rar *.sln *.vcxproj *.filters *.user *.code-workspace *.vscode/*.json"
ENGINE_PATTERNS[sithengine]+=" *.idea *.iml *.ipr *.iws CMakeLists.txt *.cmake"

# ----------------------- Find and migrate large files -----------------------
echo "🔍 Scanning for large files (>10MB)..."
find . -type f -size +10M -exec ls -lh {} \; | awk '{ print $9 ": " $5 }' 2>/dev/null || echo "No large files
found or error scanning."

echo "🔄 Setting up LFS tracking for large files..."
# Safer approach - only track new files, don't migrate existing history
git lfs install --force --skip-repo || true

# ----------------------- Apply Git LFS tracking -----------------------
echo "📦 Tracking files for engine: $ENGINE"
PATTERNS=(${ENGINE_PATTERNS[$ENGINE]})
for pattern in "${PATTERNS[@]}"; do
    git lfs track "$pattern" 2>/dev/null || true
done

# ----------------------- Show .gitattributes -----------------------
echo "📄 Current .gitattributes:"
cat .gitattributes || true

# ----------------------- Commit changes -----------------------
echo "💾 Committing LFS configuration..."
git add .gitattributes

if git diff --cached --quiet; then
    echo "ℹ️ No changes to commit."
else
    git commit -m "Enable Git LFS tracking for $ENGINE assets" || true
fi

# ----------------------- Push changes if requested -----------------------
if [ "$DO_PUSH" = "push" ]; then
    echo "🚀 Pushing to remote repository..."

    # Push LFS objects first
    echo "📤 Pushing LFS objects..."
    git lfs push origin main --all || echo "⚠️ LFS push had issues, continuing..."

    # Then push regular commits
    echo "📤 Pushing Git commits..."
    git push origin main || echo "⚠️ Push failed, check remote and credentials"
else
    echo "💡 Add 'push' as third argument to automatically push changes"
    echo "💡 Manual push commands:"
    echo " git lfs push origin main --all"
    echo " git push origin main"
fi

echo "✅ Git LFS tracking applied successfully for $ENGINE!"

Git LFS PowerShell Script (Windows)

#!/usr/bin/env pwsh
# =========================================================
# engine_gitlfs.ps1
# Unified Git LFS tracking for multiple game engines
# Ensures LFS always downloads files (--no-skip-smudge)
# Interactive selection if engine not provided
# =========================================================
# Usage: .\engine_gitlfs.ps1 [engine] [push]
# Engines supported: ue3 | goldsrc | source | idtech3 | idtech4 | cryengine1 | thiefdark | sithengine
# Optional second argument "push" will push commits to origin.

param(
    [string]$Engine = "",
    [string]$DoPush = ""
)

# ------------------ Supported engines ------------------
$SupportedEngines = @("ue3", "goldsrc", "source", "idtech3", "idtech4", "cryengine1", "thiefdark", "sithengine")

# ------------------ Interactive engine selection ------------------
if ([string]::IsNullOrEmpty($Engine)) {
    Write-Host "Please select a game engine to track with Git LFS:"
    for ($i = 0; $i -lt $SupportedEngines.Length; $i++) {
        Write-Host " $($i+1). $($SupportedEngines[$i])"
    }
    $choice = Read-Host "Enter number (1-$($SupportedEngines.Length))"

    if ($choice -match '^\d+$' -and [int]$choice -ge 1 -and [int]$choice -le $SupportedEngines.Length) {
        $Engine = $SupportedEngines[[int]$choice - 1]
        Write-Host "✅ Selected engine: $Engine"
    } else {
        Write-Host "❌ Invalid selection."
        exit 1
    }
}

# ----------------------- Dependencies ------------------------
if (-not (Get-Command git -ErrorAction SilentlyContinue)) {
    Write-Host "❌ git not installed or not in PATH."
    exit 1
}

if (-not (Get-Command git-lfs -ErrorAction SilentlyContinue)) {
    Write-Host "📦 Git LFS not found. Please install Git LFS from:"
    Write-Host "https://git-lfs.github.com/"
    exit 1
}

Write-Host "🔧 Initializing Git LFS..."
git lfs install --force

# ------------------ Define engine-specific patterns ------------------
$EnginePatterns = @{
    ue3 = @(
        "*.ico", "*.upk", "*.umap", "*.psa", "*.psk", "*.abs", "*.fxa", "*.fbx", "*.png", "*.psd", "*.wav", "*.mp4",
        "*.bik", "*.tga", "*.bmp", "*.dds", "*.jpg", "*.jpeg", "*.ogg", "*.mp3", "*.usx", "*.utx", "*.uax", "*.ukx",
        "*.unr", "*.uc", "*.u", "*.swf", "*.bin", "*.pak", "*.iso", "*.zip", "*.rar", "*.dll", "*.lib", "*.pdb",
        "*.exe", "*.sln", "*.vcproj", "*.vcxproj", "*.vcxitems", "*.filters", "*.sdf", "*.log", "*.t3d", "*.udk",
        "*.chtml", "*.max", "*.3ds", "*.mb", "*.ma", "*.blend", "*.ztl", "*.ztb", "*.tbx", "*.mtl", "*.obj", "*.stl",
        "*.bgeo", "*.abc", "*.ply", "*.gltf", "*.glb", "*.igs", "*.step", "*.stp", "*.x3d", "*.bsp", "*.vox",
        "*.tiff", "*.tif", "*.exr", "*.hdr", "*.pfm", "*.raw", "*.ies", "*.sbsar", "*.sbs", "*.sppr", "*.tx",
        "*.xcf", "*.mat", "*.cg", "*.cgfx", "*.sma", "*.smi", "*.ptx", "*.bvh", "*.c3d", "*.anim", "*.skel", "*.rig",
        "*.mc", "*.mcx", "*.phy", "*.udk", "*.ukx", "*.uax", "*.utx", "*.usx", "*.fxa", "*.fxp", "*.bik", "*.swf",
        "*.gtl", "*.gma", "*.pak", "*.pakchunk*", "*.pak.info", "*.umx", "*.uplugin", "*.uproject", "*.uasset",
        "*.uexp", "*.ubulk", "*.wav", "*.mp3", "*.ogg", "*.flac", "*.m4a", "*.aac", "*.ac3", "*.mov", "*.avi",
        "*.wmv", "*.flv", "*.mkv", "*.m4v", "*.mxf", "*.r3d", "*.7z", "*.tar", "*.gz", "*.lz4", "*.lzma", "*.xz",
        "*.cab", "*.msi", "*.vcxproj.user", "*.vsconfig", "*.props", "*.targets", "*.filters", "*.hlsl", "*.glsl",
        "*.fx", "*.fxc", "*.bat", "*.sh", "*.cmd", "*.patch", "*.diff", "*.cmake", "*.mak", "*.vssettings",
        "*.code-workspace", "*.vscode/*.json", "*.idea", "*.iml", "*.ipr", "*.iws", "CMakeLists.txt", "*.cmake"
    )
    goldsrc = @(
        "*.wad", "*.bsp", "*.mdl", "*.spr", "*.wav", "*.mp3", "*.txt", "*.cfg", "*.exe", "*.dll", "*.zip", "*.rar",
        "*.sln", "*.vcxproj", "*.filters", "*.user", "*.code-workspace", "*.vscode/*.json", "*.idea", "*.iml",
        "*.ipr", "*.iws", "CMakeLists.txt", "*.cmake"
    )
    source = @(
        "*.vmf", "*.vmt", "*.vtf", "*.mdl", "*.wav", "*.mp3", "*.txt", "*.cfg", "*.exe", "*.dll", "*.zip", "*.rar",
        "*.sln", "*.vcxproj", "*.filters", "*.user", "*.code-workspace", "*.vscode/*.json", "*.idea", "*.iml",
        "*.ipr", "*.iws", "CMakeLists.txt", "*.cmake"
    )
    idtech3 = @(
        "*.pk3", "*.bsp", "*.shader", "*.tga", "*.jpg", "*.png", "*.wav", "*.mp3", "*.cfg", "*.script", "*.pak",
        "*.sln", "*.vcxproj", "*.filters", "*.user", "*.code-workspace", "*.vscode/*.json", "*.idea", "*.iml",
        "*.ipr", "*.iws", "CMakeLists.txt", "*.cmake"
    )
    idtech4 = @(
        "*.pk4", "*.map", "*.tga", "*.jpg", "*.png", "*.shader", "*.wav", "*.mp3", "*.cfg", "*.script", "*.pak",
        "*.sln", "*.vcxproj", "*.filters", "*.user", "*.code-workspace", "*.vscode/*.json", "*.idea", "*.iml",
        "*.ipr", "*.iws", "CMakeLists.txt", "*.cmake"
    )
    cryengine1 = @(
        "*.tga", "*.dds", "*.mtl", "*.xml", "*.cgf", "*.chr", "*.skin", "*.anm", "*.caf", "*.wav", "*.ogg", "*.mp3",
        "*.lua", "*.cfg", "*.pak", "*.zip", "*.7z", "*.log", "*.dll", "*.so", "*.exe", "*.sln", "*.vcxproj",
        "*.filters", "*.user", "*.code-workspace", "*.vscode/*.json", "*.idea", "*.iml", "*.ipr", "*.iws",
        "CMakeLists.txt", "*.cmake"
    )
    thiefdark = @(
        "*.mis", "*.gam", "*.bin", "*.crf", "*.cam", "*.pkt", "*.wav", "*.voc", "*.tga", "*.pcx", "*.pal", "*.mat",
        "*.mot", "*.cal", "*.vdb", "*.fnm", "*.bin", "*.ms", "*.h", "*.hxz", "*.hx", "*.hk", "*.eq", "*.shock",
        "*.key", "*.txt", "*.cfg", "*.exe", "*.dll", "*.zip", "*.rar", "*.sln", "*.vcxproj", "*.filters", "*.user",
        "*.code-workspace", "*.vscode/*.json", "*.idea", "*.iml", "*.ipr", "*.iws", "CMakeLists.txt", "*.cmake"
    )
    sithengine = @(
        "*.3do", "*.anm", "*.bm", "*.cmp", "*.cfg", "*.dac", "*.dad", "*.dao", "*.mat", "*.md", "*.md3", "*.pal",
        "*.pup", "*.sfx", "*.tga", "*.txt", "*.vox", "*.wav", "*.git", "*.key", "*.mat", "*.snd", "*.snd", "*.voc",
        "*.wal", "*.wed", "*.zkn", "*.zkp", "*.zkl", "*.exe", "*.dll", "*.zip", "*.rar", "*.sln", "*.vcxproj",
        "*.filters", "*.user", "*.code-workspace", "*.vscode/*.json", "*.idea", "*.iml", "*.ipr", "*.iws",
        "CMakeLists.txt", "*.cmake"
    )
}

# ----------------------- Find and migrate large files -----------------------
Write-Host "🔍 Scanning for large files (>10MB)..."
Get-ChildItem -Recurse -File | Where-Object { $_.Length -gt 10MB } | ForEach-Object {
    Write-Host "$($_.Name): $([math]::Round($_.Length/1MB, 2)) MB"
}

Write-Host "🔄 Setting up LFS tracking for large files..."
git lfs install --force --skip-repo

# ----------------------- Apply Git LFS tracking -----------------------
Write-Host "📦 Tracking files for engine: $Engine"
$patterns = $EnginePatterns[$Engine]
foreach ($pattern in $patterns) {
    git lfs track $pattern 2>$null
    if ($LASTEXITCODE -ne 0) {
        Write-Host "⚠️ Could not track pattern: $pattern"
    }
}

# ----------------------- Show .gitattributes -----------------------
Write-Host "📄 Current .gitattributes:"
if (Test-Path .gitattributes) {
    Get-Content .gitattributes
} else {
    Write-Host "No .gitattributes file found"
}

# ----------------------- Commit changes -----------------------
Write-Host "💾 Committing LFS configuration..."
git add .gitattributes

$changes = git status --porcelain .gitattributes
if ($changes) {
    git commit -m "Enable Git LFS tracking for $Engine assets"
} else {
    Write-Host "ℹ️ No changes to commit."
}

# ----------------------- Push changes if requested -----------------------
if ($DoPush -eq "push") {
    Write-Host "🚀 Pushing to remote repository..."

    Write-Host "📤 Pushing LFS objects..."
    git lfs push origin main --all

    Write-Host "📤 Pushing Git commits..."
    git push origin main
} else {
    Write-Host "💡 Add 'push' as second argument to automatically push changes"
    Write-Host "💡 Manual push commands:"
    Write-Host " git lfs push origin main --all"
    Write-Host " git push origin main"
}

Write-Host "✅ Git LFS tracking applied successfully for $Engine!"

✅ This ensures all large game assets (textures, models, sounds, binaries) are tracked efficiently with Git LFS, reducing repository size and improving collaboration.

ForgejoGitLFS Team Setup & Clone Repo Tutorial

Step 1 — Setup Forgejo on WineJS

Step 2 — Clone Repo Automaticly - Script Generator

Step 3 — Adding Collaborators

Step 4 — Setup Team Access

Step 5 — Setup VSCode and Visual Studio 2022

6 — Enable Git LFS on Developer Machines

Step 7 — Setting up Webhooks

🔔 Discord Webhooks

📋 Team Management Webhooks

Custom Webhook Servers

🐍 Python Webhook Receiver Example

⚙️ Posting Back to Discord with Python

Step 8 — Enhancing Forgejo with Tampermonkey

How to Install: