Gitea — Guide — Felhom.eu ← Apps Gitea Your own Git server - a GitHub-like interface and private repositories ● Running git.tester4.test Open ↗ What is it for? Private Git repositories on your own server A GitHub-like interface: pull requests, issues, a wiki CI/CD pipelines (Gitea Actions - compatible with GitHub Actions) Organisations and teams A container registry and a package registry First steps Open git.tester4.test in your browser Follow the first-run setup wizard Create the admin account Create your first repository Clone it: git clone https://git.tester4.test/user/repo.git Bring over an existing project You can bring over a project kept elsewhere, with its whole history. Select the + sign at the top right and choose „New Migration”. Choose where the project comes from, for example GitHub or Git. Paste the project's clone address into „Migrate / Clone From URL”. If only you should see it, tick „Make repository private”. Select „Migrate Repository” and wait until it finishes. Work together on a repository Several people can work on one repository if each has their own account. Open the repository and select the „Settings” tab. On the left, choose „Collaborators”. Type the family member's user name and select „Add Collaborator”. Next to their name, set what they may do: „Write” or „Read”. Keep track of tasks An issue is a task or a fault that you track next to the repository. Open the repository and select the „Issues” tab. Select „New Issue”, and write a title and a description. At „Assignees” you can choose who deals with it. Select „Create Issue”. When it is done, select „Close Issue” at the bottom of the issue. Two-step sign-in Signing in then needs your phone as well as the password, so your account is safer. Select your profile picture at the top right and choose „Settings”. On the „Security” tab, select „Enroll in Two-Factor Authentication”. Scan the picture with the authenticator app on your phone, type the code into „Passcode” and select „Verify”. Git then asks for a token instead of the password. On the „Applications” tab, type a name into „Token Name”, choose „Read and Write” in the repository row, and select „Generate Token”. Copy the token at once: it is not shown again. Frequently asked questions Why does cloning over SSH not work? The box makes Gitea reachable only at its web address (git.tester4.test), not over SSH. Use the HTTPS address to clone. How does a family member get an account? A stranger cannot sign up: the box closed sign-up after the first account. The admin creates a new account on the „Site Administration” page, at „User Accounts”, with „Create User Account”. Who can see my repositories? By default, anyone who opens git.tester4.test can see a public repository, even without signing in. A private one only you and the collaborators. To change it later, use „Make Private” in the „Danger Zone” part of the repository's „Settings” tab. Why does git not accept my password? If you turned on two-step sign-in, git asks for a token instead of the password. You make the token on the „Applications” tab and type it where the password goes. Where are my repositories? In Gitea's own data store, on the box. You see their backup on the „Data and backup” tab. Documentation Official documentation ↗