Windows
Git for Windows
Install Git from the official git-scm.com Windows page. Git for Windows includes Git LFS (leave the Git LFS box checked). Then run git lfs install once in Git Bash or PowerShell.
Private repository
This short guide is for people Miranda has invited to the private game repository. You’ll install Git and Git LFS, sign in to the Git server, add an SSH key, and clone the project so you can open it in Unreal Engine 5.7.
Accounts are invite-only. There is no public sign-up on the Git server. If you don’t have a username yet, contact Miranda and she will create an account for you.
Use the official pages below. Don’t download installers from unofficial mirrors. After installing Git, you’ll still need to run git lfs install once, even on Windows.
Windows
Install Git from the official git-scm.com Windows page. Git for Windows includes Git LFS (leave the Git LFS box checked). Then run git lfs install once in Git Bash or PowerShell.
macOS & Linux
Install Git from the official macOS or Linux page, then install Git LFS from git-lfs.com (the official Git Large File Storage site) and run git lfs install. LFS is required for large Unreal files.
Windows & Mac
Optional, but helpful if you’d rather not live in the terminal. GitHub Desktop is free and works with any Git server, including this one — you do not need a GitHub.com account to clone Miranda’s repository. Fork is another polished client that also works with self-hosted Git.
All platforms
Install the Epic Games Launcher from the official Unreal Engine download page, sign in with an Epic account, open the Unreal Engine Library, and install Unreal Engine 5.7 specifically (not just “the latest”). You can also get the Launcher from the Epic Games Store download page.
Do these in order the first time. After that, you’ll just pull, commit, and push as usual.
Install the software from the downloads above. Then, in a terminal (Git Bash or PowerShell on Windows; Terminal on Mac or Linux), run:
git lfs install
You only need to do this once per computer. On Windows, Git LFS is already bundled with Git for Windows — still run this command so LFS is turned on for your account.
Open https://git.mirandalynn.dev and sign in with the username and temporary password Miranda sent you. The first time you sign in, you’ll be asked to change that temporary password. Choose a strong password and keep it to yourself.
In the same terminal, create a new key (press Enter to accept the default file location; you can set a passphrase if you want):
ssh-keygen -t ed25519
Then copy the contents of the public key file, id_ed25519.pub. On Mac or Linux, that’s usually ~/.ssh/id_ed25519.pub. On Windows, look in C:\Users\YourName\.ssh\id_ed25519.pub, or run type %USERPROFILE%\.ssh\id_ed25519.pub in Command Prompt or Get-Content ~/.ssh/id_ed25519.pub in PowerShell or Git Bash.
Never share the file without .pub — that’s your private key and should stay on your computer.
While signed in at git.mirandalynn.dev, open Settings → SSH / GPG Keys, add a new SSH key, paste the public key, and save. You’ll need this key to clone and push over SSH.
This is the URL you should use day to day:
git clone ssh://git@git.mirandalynn.dev:2222/TerraGenesis/TerraGenesis.git
The SSH port is 2222, not the default 22. The first time you connect, Git may ask you to confirm the server’s host key — that’s expected.
Use SSH for big Unreal / LFS files. HTTPS uploads that take longer than 60 seconds are cut off by the web proxy, which can fail large asset pushes. SSH does not have that limit, so use the SSH remote when you’re uploading large LFS files.
HTTPS is fine as a fallback for a first pull or for small changes:
git clone https://git.mirandalynn.dev/TerraGenesis/TerraGenesis.git
When HTTPS asks you to sign in, use your Gitea username and password, or a personal access token from Settings → Applications. If you cloned with HTTPS and later need to push large files, switch the remote:
git remote set-url origin ssh://git@git.mirandalynn.dev:2222/TerraGenesis/TerraGenesis.git
After the clone finishes (the first clone can take a while because of LFS assets), open the .uproject file in the project folder with Unreal Engine 5.7, or launch 5.7 from the Epic Games Launcher and open the project from there. If the editor asks to rebuild modules, let it.
The steps are the same on every system. These are just the small differences.
Install Git for Windows (includes Git LFS). Use Git Bash or PowerShell for the commands. GitHub Desktop and Fork can open the folder after you clone it, or clone from the SSH URL in the app’s “Clone repository” / URL field. Windows’ OpenSSH and Git’s own SSH both work; if a host-key prompt appears, that’s normal.
Install Git from the official macOS page (Homebrew, MacPorts, or Xcode Command Line Tools), then install Git LFS and run git lfs install. GitHub Desktop and Fork are available for Mac. Use Terminal for ssh-keygen and the clone command, or paste the SSH URL into your Git app.
Install Git from the official Linux page (usually your package manager), then install Git LFS and run git lfs install. Official GitHub Desktop and Fork builds are for Windows and Mac only, so on Linux use the command line (or a Git GUI you already trust). The SSH clone command is the same.