stop_cloudflare/instructions_git.md

70 lines
2.6 KiB
Markdown
Raw Normal View History

2019-07-11 15:19:30 +02:00
# How to setup git
2019-04-29 12:04:38 +02:00
This procedure will give you a cloudflare-tor fork with a
privacy-respecting configuration to do pushes with SSH over Tor using
2019-07-11 15:19:30 +02:00
the onion host for codeberg.org ("CDB"). This procedure is designed
2019-04-29 12:04:38 +02:00
for ***linux***. The first step covers Windows too, but these
instructions probably need more adaptations for Windows and other
platforms.
2019-07-08 02:34:52 +02:00
- Linux: `aptitude install git tor ssh`
- Windows: Download `https://github.com/git-for-windows/git/releases/PortableGit-2.21.0-64-bit.7z` & run `git-bash.exe`
[1]
2019-04-29 12:04:38 +02:00
```
host notabug-*
hostname qs3zumwfci4tntnd.onion
ForwardX11 no
ProxyCommand connect -4 -S 127.0.01:9050 %h %p
host notabug-snowden
IdentityFile /home/user/.ssh/id_rsa_nab-snowden
```
2019-07-08 02:34:52 +02:00
[2]
2019-04-29 12:04:38 +02:00
```
[user]
email = BM-yadayadayada6fgnLfybVnCcWf25AGZcgg@bitmessage.ch
name = snowden
[remote "origin"]
url = git@notabug-snowden:snowden/cloudflare-tor.git
fetch = +refs/heads/*:refs/remotes/origin/*
[branch "master"]
remote = origin
merge = refs/heads/master
```
2019-07-08 02:34:52 +02:00
<ol>
<li> install Git, SSH(Not Windows), and Tor (if you haven't already)
<li> create a `notabug.org` account (username "snowden" will be used for this example)
<li> create an SSH key pair `$ ssh-keygen -t rsa -N '' -C 'snowden at notabug' -f "$HOME"/.ssh/id_rsa_nab-snowden`
<li> edit `$HOME/.ssh/config`[1]
<li> copy `"$HOME"/.ssh/id_rsa_nab-snowden.pub` to clipboard
<li> notabug.org > settings > SSH Keys > add key (paste from clipboard)
2019-07-12 04:59:13 +02:00
<li> $ `firefox https://codeberg.org/crimeflare/cloudflare-tor`
2019-07-08 02:34:52 +02:00
<li> fork it (top right corner)
<li> go to the directory you want the project to be rooted in (hereafter we'll call it `$project_root`).
<li> anonymously download your fork: $ `torsocks git clone https://notabug.org/snowden/cloudflare-tor`
<li> edit `$project_root/cloudflare-tor/.git/config` to include the
account name and email address that will be on every commit, as
well as the URL[2]
<li> make your first change
<li> (from `$project_root`) $ `git add . -u -n`
<li> check that the files listed are what you changed and intend to push upstream
<li> if yes: `$ git add . -u`
<li> $ `git commit -m 'description of first change'`
<li> $ `git push origin master`
2019-07-12 04:59:13 +02:00
<li> $ `firefox https://codeberg.org/crimeflare/cloudflare-tor`
<li> make a new pull request
</ol>
&nbsp;
2019-04-29 12:04:38 +02:00
Notice that only the `git clone` command has a `torsocks` prefix and
all git commands thereafter do not. Whenever git operates on the
cloudflare-tor project, all connections to NAB are automatically over
Tor with this configuration (because the `url` in `.git/config`
references the virtual host `notabug-snowden` in `~/.ssh/config` which
uses the onion address).