Create a shell user if you have not done so already. You can use an existing shell user if you wish.
Click on Applications in the control panel sidebar.
Click the button labeled "+ Add Application" in the upper-left corner of the content area.
Select Gitea as the application type.
Enter a name for your application in the Name field.
This name will be used to create a subdirectory in your shell user's
appsdirectory such as
Select the shell user that will host the application.
If you have multiple servers, be sure to select the shell user that is located on the server from which you intend to serve your site.
Click the "Add Application" button to save your new application.
A notification will appear in the control panel when the application is ready. This may take a minute or longer. The notification will contain your initial Gitea username and password.
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.
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