Differences

This shows you the differences between two versions of the page.

--- hosted_git_repos_-_gitea_on_sdf [2023/05/22 17:26] – Added a troubleshooting section to highlight port 2222 for ssh kashifshah
+++ hosted_git_repos_-_gitea_on_sdf [2024/03/04 18:19] (current) – [Introduction] tweak to show up on search, maybe? peteyboy
@@ Line 1: / Line 1: @@
+====== Introduction ======
+Gitea is a web-based git hosting service that like GitHub, Gitlab, or BitBucket. SDF provides its own installation located at [[https://git.sdf.org]].
+For advanced users here is how to [[access SDF gitea using ssh keys]]
+This tutorial is pretty basic and doesn't cover what is in the [[scmgit-intro | GIT SCM Introduction]].
+====== Getting Started ======
+===== Explore Public Projects =====
+Visit [[https://git.sdf.org/explore/repos]] to see the current listing and to find interesting projects.
+===== Create an Account =====
+  - become a [[http://sdf.org/?join#meta|MetaARPA]] member
+  - email membership to request an account
+  - wait for the welcome email with your randomly-generated Gitea password
+  - log in to [[http://git.sdf.org|git.sdf.org]] using the credentials provided in the welcome email
+==== Create A New Repo ====
+  * click the "+" in the upper left
+  * choose //New Repository//
+  * name the repo and provide additional data
+  * decide if this is to be a private or public repo
+  * follow the instructions presented after the action chosen has been completed
+  * on the gitea page for your new project, click the copy button on the other side of the text box that has the options [HTTP] and [SSH]. The text box has the clone address for your new project
+  * back in SDF shell, find a place to keep your gitea projects, and in that folder enter:''git clone <URL>'' It will ask you to log in, then it will connect your local folder git with your repo.
+  * Put any files you make for the project in that folder, then:
+    * add them with ''git add <file>''
+    * commit those changes with ''git commit''
+    * push those changes up to your repo with ''git push''
+    * continue!
+==== Migrate An Existing Repo ====
+(//e.g., one currently living on GitHub//)
+  * click the "+" in the upper left
+  * choose //Migrate Repository//
+  * in the next screen, provide the repo URL (e.g., //GitHub//) to migrate over
+  * follow the instructions presented after the action chosen has been completed
+==== Troubleshooting ====
+SSH and Gitea - note that Gitea's ssh port is ''2222'': [[access_sdf_gitea_using_ssh_keys|]]
+====== Next Steps to Enlightemment ======
+  * [[scmgit-intro|learn git]]!
+  * start hacking!
+  * explore existing projects, //fork// one
+  * create your project or team!
+  * //[[https://docs.gitea.io/en-us/|Official Gitea Docs]]//