Deploy Gitea with Marketplace Apps

Traducciones al Español
Estamos traduciendo nuestros guías y tutoriales al Español. Es posible que usted esté viendo una traducción generada automáticamente. Estamos trabajando con traductores profesionales para verificar las traducciones de nuestro sitio web. Este proyecto es un trabajo en curso.

Gitea Marketplace App

Gitea is a community managed, painless, self-hosted Git service. Gitea is a complete solution for all aspects of your software development. At its core, Gitea serves as your centralized remote Git repository. Gitea also features built-in tools that represent every task in your development workflow, from planning to testing to releasing.

Self-hosting your software development with the Gitea Marketplace App offers total control of your codebase. At the same time, its familiar interface eases collaboration for you and your team. Gitea is one of the most popular self-hosted Git repository platforms, allowing you to benefit from a robust set of integrated tools and an active community.

Deploy a Gitea Marketplace App

Linode’s App Marketplace allows you to easily deploy software on a Linode using the Linode Cloud Manager. To access Linode’s App Marketplace:

  1. Log in to your Linode Cloud Manager account.

  2. From the Linode dashboard, click on the Marketplace button in the left-hand navigation menu.

  3. The Linode creation page appears, with the Marketplace tab pre-selected.

  4. Under the Select App section, select the app you would like to deploy:

    Select a Marketplace App to deploy

  5. Once you have selected the app, proceed to the app’s Options section and provide values for the required fields.

Gitea Options

You can configure your Gitea App by providing values for the following fields:

FieldDescription
MySQL root PasswordThe root password for your MySQL database. Required.
Gitea Database PasswordThe password for your Gitea database user. Required.
The limited sudo user to be created for the LinodeThe Linux username created for this Linode with sudo permissions.
The password for the limited sudo userThe password for your limited sudo user.
SSH Public KeyThe public key for SSH access with your limited sudo user.
Enable passwordless sudo access for the limited user?Select Yes to disable SSH password authentication for your limited sudo user as an additional security measure. Requires an SSH Public Key for SSH access to your Linode.
Disable root access over SSH?Select Yes to disallow root logins over SSH as an additional security measure. Requires a configuration of a limited sudo user for SSH access to your Linode.
Configure automatic security updates?Select Yes to enable automatic security updates for your Linode.
Use fail2ban to prevent automated instrusion attempts?Select Yes to enable SSH login protection with Fail2Ban as an additional security measure.
Your Linode API TokenYour Linode API Token is needed to create DNS records. If this is provided along with the Subdomain and Domain fields, the installation attempts to create DNS records via the Linode API. If you don’t have a token, but you want the installation to create DNS records, you must create a token to use in this field before continuing.
SubdomainThe subdomain you wish the installer to create a DNS record for during setup, for example www. Requires a Domain and API Token. If no subdomain is specified, a DNS record is created for the root domain.
DomainThe domain name where you wish to host your Gitea server, for example example.com. Requires an API Token. For more guidance on using domains with Linode, see our DNS Manager Guide.
SOA Email for your domainThe email address to register as your Start of Authority (SOA). This field is required for creating DNS records for a new domain.
Do you need an MX record for this domain?Select Yes to automatically configure an MX record for the purpose of sending emails from your Linode. Additional configuration with Gitea is required after installation to enable sending emails with this app.
Do you need an SPF record for this domain?Select Yes to automatically configure an SPF record for the purpose of sending emails from your Linode. Additional configuration with Gitea is required after installation to enable sending emails with this app.
Would you like to use a free Let’s Encrypt SSL certificate for your fully qualified domain name?Select Yes to configure an SSL Certificate for HTTPS access to your Gitea remote desktop. Requires a Domain and Admin Email.
Admin Email for Let’s Encrypt certificateThe email address to register with Certbot when generating an SSL certificate for your fully qualified domain name. This field is required for HTTPS access to your Gitea remote desktop.
This guide may involve or result in sending email. In an effort to fight spam, Linode restricts outbound connections on ports 25, 465, and 587 on all Linodes for new accounts created after November 5th, 2019. For more information, please see Sending Email on Linode.
This guide may involve or result in sending email. In an effort to fight spam, Linode restricts …

Linode Options

After providing the app specific options, provide configurations for your Linode server:

ConfigurationDescription
Select an ImageDebian 10 is currently the only image supported by the Gitea Marketplace App, and it is pre-selected on the Linode creation page. Required.
RegionThe region where you would like your Linode to reside. In general, it’s best to choose a location that’s closest to you. For more information on choosing a DC, review the How to Choose a Data Center guide. You can also generate MTR reports for a deeper look at the network routes between you and each of our data centers. Required.
Linode PlanYour Linode’s hardware resources. We recommend that you use, at minimum, an 4GB Linode plan for your Gitea server. For more information on Gitea’s system requirements see their official documentation. If you decide that you need more or fewer hardware resources after you deploy your app, you can always resize your Linode to a different plan. Required.
Linode LabelThe name for your Linode, which must be unique between all of the Linodes on your account. This name is how you identify your server in the Cloud Manager Dashboard. Required.
Root PasswordThe primary administrative password for your Linode instance. This password must be provided when you log in to your Linode via SSH. The password must meet the complexity strength validation requirements for a strong password. Your root password can be used to perform any action on your server, so make it long, complex, and unique. Required.

When you’ve provided all required Linode Options, click on the Create button. Your Gitea App will complete installation anywhere between 3-7 minutes after your Linode has finished provisioning.

Getting Started after Deployment

Access your Gitea Site

After Gitea has finished installing, you can access your Gitea site using a web browser to complete setup and begin using your app.

  1. Enter your Linode’s fully qualified domain name (for example, https://www.example.com) or IPv4 address (for example, http://192.0.2.0) into a browser window to access the Gitea welcome page. Select the Register link to reach the initial configuration screen.

    The Gitea welcome page.

  2. Enter your Gitea Database Password in the Password field.

    Gitea initial configuration settings.

  3. Replace localhost with your Linode’s fully qualified domain name or IPv4 address under SSH Server Domain and Gitea Base URL fields. Specify https in the Gitea Base URL field if you configured an SSL certificate for your domain.

    Gitea general settings.

  4. Complete any other desired configurations, then select Install Gitea to complete initial configuration.

  5. You can now register a new administrative user and manage repositories with your Gitea App. For more configuration instructions and settings, refer to the official Gitea Documentation.

Software Included

The Gitea Marketplace App installs the following software on your Linode:

SoftwareDescription
GiteaOpen source remote Git repository software. v1.13.0
MariaDBOpen source relational database fork of MySQL.
NGINXOpen source web server. Used as a reverse proxy by this app. See our guide on Getting Started with NGINX for more information.
UFWFirewall utility. Ports 22/tcp, 80/tcp, and 443/tcp for IPv4 and IPv6 are enabled with installation of this app. Additional ports must be opened to send email from your Linode for use with this app. See our guide on How to Configure a Firewall with UFW for instructions.
Note
Currently, Linode does not manage software and systems updates for Marketplace Apps. It is up to the user to perform routine maintenance on software deployed in this fashion.

More Information

You may wish to consult the following resources for additional information on this topic. While these are provided in the hope that they will be useful, please note that we cannot vouch for the accuracy or timeliness of externally hosted materials.

This page was originally published on

Create a Linode account to try this guide with a $100 credit.
This credit will be applied to any valid services used during your first 60 days.

Your Feedback Is Important

Let us know if this guide made it easy to get the answer you needed.


Join the conversation.
Read other comments or post your own below. Comments must be respectful, constructive, and relevant to the topic of the guide. Do not post external links or advertisements. Before posting, consider if your comment would be better addressed by contacting our Support team or asking on our Community Site.