Welcome to Gitea!
The first time you start Gitea and launch its UI, it will take you to a configuration page. You can just accept the settings on this page, and Gitea will be installed.
Gitea works pretty much the same as Github. An exception to this is that, when accessing your Embassy's Gitea instance remotely (that is, from outside your Embassy's local network), you (currently) must use Tor.
If you are on the same LAN as your Embassy, you can access it over .local using HTTP. SSH support over .local coming later.
To use git
over HTTP/Tor with Gitea with either of the two methods listed
below, you will need a
Tor proxy
running on port 9050.
To use git over HTTP/Tor with your Gitea instance, you will need to set up your git config to use this proxy whenever you interact with a git remote that is hosted over HTTP (most git servers these days don't use cleartext http, but if you happen to access one after running this command, it will be accessed over Tor as well since this is a global setting).
(Note: using cleartext HTTP over Tor is very secure when accessing hidden services with .onion URLs, such as your Embassy Gitea instance. This is because Tor encrypts all traffic, and authentication is taken care of by the URL itself.)
git config --global http.proxy "socks5h://127.0.0.1:9050"
To use git over SSH/Tor with Gitea, enter this command on your development machine to modify your ssh config to proxy all SSH connections to .onion domains through your Tor proxy:
echo -e '\nHost *.onion\n ProxyCommand /usr/bin/nc -xlocalhost:9050 -X5 %h %p' >> ~/.ssh/config
You will also need to have netcat
(nc
) installed, which should already be
installed if you have Mac or Linux. If it isn't, you can use
apt install netcat
or brew install netcat
on MacOS. If you have Windows, I
can't help you. Maybe
this will
work.
Now you can do things like git clone
, git push
, git pull
etc.
Enjoy!