Once you have your own VPS or other Internet-available server, you can start hosting your own git repositories. The goal of this tutorial is - for you to go from + for you to go from

git clone github.com/...

- to +

git clone YourLandChadDomainName.xyz/...

- so you can cultivate your own homegrown, grass fed code, rather than +

+ so you can cultivate your own homegrown, grass-fed code, rather than relying on a centralized proprietary service like GitHub.

What's not included in this tutorial

- -

- We will not set up a web front end. Your only interaction with - these repos will be via the git command line tool. -
- We will not support multiple users. It's expected only you, the - server owner, have write access to these repos. -

Installing git

You most likely already have it installed on your server, but if not, - run + run:

apt install git

We don't need any additional software, git itself ships with everything needed to host a remote repository!

@@ -75,24 +64,27 @@

If you're logged in to your server as root and have git installed, you can become the git user by executing +

su git

Now navigate to/create your desired directory, for example +


-cd /srv
-mkdir git
-

cd /srv
+mkdir git

Create the repo

Now you can create the bare repository with +

git init --bare my-repo.git

By convention, bare repository names end with ".git".

@@ -107,12 +99,12 @@ mkdir git

You will need to be able to login remotely via ssh as the git user we've used before. To do this, you will either - need to set up a password for the git user with - -

passwd git

- + need to set up a password for the git user by running + passwd git, or copy your public SSH key from your local machine to /home/git/.ssh/authorized_keys. + See the SSH keys instructional for details + (just log in as git instead of root).

Syncing a new repository with your server

@@ -127,7 +119,8 @@ mkdir git

A remote is just a named URL remembered in your repo's configuration. So we need a name and a URL. By convention, the "main" remote is called - "origin". The URL has the format user@host:path, where + "origin". The URL has the format user@host:path, where: +

@@ -135,7 +128,7 @@ mkdir git we've already worked with before.
- host is a DNS hostname pointing to your server. + host is your domain name. Alternatively you could even use your server's raw IP address.
@@ -146,10 +139,12 @@ mkdir git

- So, to create a new remote, run + So, to create a new remote, run: +
```
git remote add origin git@yourdomain.xyz:/srv/git/my-repo.git
```
+
Now you'll be able to run git push origin master to push your commits or git pull origin to pull from the remote.
@@ -159,25 +154,27 @@ mkdir git
If you've already set up your local repository to sync with a service like GitHub it probably already has a remote called "origin". You can - see your repo's remotes with + see your repo's remotes with: +
```
git remote -v
```
+
You can follow the above instructions, substituting an arbitrary other name other than "origin" to create a differently named remote, e.g. +
```
git remote add vps git@...
```
+
Now you'll be able to push/pull with git push vps master and git pull vps, respectively.

Or, to completely sever ties with your centralized git provider, first - remove the original origin with - -
```
git remote remove origin
```
- + remove the original origin with: + git remote remove origin and then follow the instructions as above.
diff --git a/index.html b/index.html index 06286fa..7c3b9ab 100644 --- a/index.html +++ b/index.html @@ -58,8 +58,8 @@
-- cgit v1.2.3

Hosting Your Own Git Repositories

Hosting Your Own Git Repositories

What's not included in this tutorial

Installing git

Create the repo

Syncing a new repository with your server