Git is a free and open source distributed version control system which is installed on all Opalstack servers.
You can use the
git command while logged in to your Opalstack server as one of your shell users. For example, to clone a Git repository from GitHub:
git clone https://github.com/xxxx/yyyy.git
The repository will be cloned into a subdirectory
yyyy of the current directory.
To install a Gitea application follow our general instructions for adding applications and select "Gitea" as the application type in step 5.
Create a site to serve your Gitea application - see Managing Sites for instructions on how to create a site.
SSH into your shell user's server and update
/home/username/app/appname/custom/conf/app.inito set the
ROOT_URLparameters to use your site's domain.
Restart the app:
Log in to your Gitea site and set your email address to the address that you want to use with your Gitea profile.
Using SSH Keys with Gitea¶
Gitea supports the use of SSH keys to enable secure password-less access to your Git repositories.
If you are already using SSH keys to access your shell account, you'll need to create a new key for Gitea.
To set it up:
Open your terminal application on your local system and generate a new key by executing the following commands, replacing
mydomain_comwith the domain name and suffix assigned to your Gitea site:
mkdir -p ~/.ssh touch ~/.ssh/config chmod 600 ~/.ssh/config chmod 700 ~/.ssh ssh-keygen -t rsa -f $HOME/.ssh/gitea_mydomain_com_rsa -N ""
Edit your local
~/.ssh/configwith the following contents, replacing
gitea.mydomain.comwith the domain assigned to your Gitea site and
gitea_mydomain_com_rsawith the name of the key you created in step 1:
Host gitea.mydomain.com IdentityFile ~/.ssh/gitea_mydomain_com_rsa
Run the following command to output the public key to your terminal:
Select the output and copy it to your clipboard.
Log into your Gitea site and go to
There, locate the "Manage SSH Keys" box and click the blue "Add Key" button in the right-hand corner.
Enter a name for your key, then paste the output from step 3 into the content box.
Save the key by clicking the green "Add Key" button below the form.
At this point you should be able to access your repos over SSH with no password with your Gitea app's shell user. For example:
git clone firstname.lastname@example.org:username/reponame.git