Skip to content

Commit ca2b7ef

Browse files
josephcardillo-akamaiMagda Sulik
andauthored
[Update] Gitea Marketplace OCA Documentation (#7235)
* update gitea os version and instructions * fix broken image link * editorial review * editorial review --------- Co-authored-by: Magda Sulik <you@example.com>
1 parent 63b5358 commit ca2b7ef

File tree

4 files changed

+12
-39
lines changed

4 files changed

+12
-39
lines changed
-50.1 KB
Binary file not shown.
530 KB
Loading

docs/marketplace-docs/guides/gitea/index.md

Lines changed: 12 additions & 39 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: "Deploy Gitea through the Linode Marketplace"
33
description: "This is a step-by-step guide on how to deploy the Gitea application, a community managed, self-hosted Git service, by using the Linode One-Click App Marketplace."
44
published: 2021-01-04
5-
modified: 2022-03-08
5+
modified: 2025-04-08
66
keywords: ['Gitea','version control','git']
77
tags: ["linode platform","version control system","marketplace","cloud-manager"]
88
external_resources:
@@ -15,7 +15,7 @@ marketplace_app_id: 688911
1515
marketplace_app_name: "Gitea"
1616
---
1717

18-
[Gitea](https://gitea.io/) 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.
18+
[Gitea](https://gitea.io/) 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.
1919

2020
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.
2121

@@ -31,65 +31,38 @@ Self-hosting your software development with the Gitea Marketplace App offers tot
3131

3232
## Configuration Options
3333

34-
- **Supported distributions:** Debian 10
34+
- **Supported distributions:** Ubuntu 24.04 LTS
3535
- **Recommended minimum plan:** 4GB Dedicated Compute Instance
3636

37-
### Gitea Options
38-
39-
- **MySQL root Password** *(required)*: The root password for your MySQL database.
40-
- **Gitea Database Password** *(required)*: The password for your Gitea database user.
41-
42-
{{% content "marketplace-limited-user-fields-shortguide" %}}
43-
- **Enable passwordless sudo access for the limited user?** Select **Yes** to [disable SSH password authentication](/docs/products/compute/compute-instances/guides/set-up-and-secure/#ssh-daemon-options) for your limited sudo user as an additional security measure. Requires an **SSH Public Key** for SSH access to your Linode.
44-
45-
#### Additional Security Configuration
46-
47-
- **Configure automatic security updates?** Select **Yes** to enable automatic security updates for your Linode.
48-
- **Use fail2ban to prevent automated instrusion attempts?** Select **Yes** to enable [SSH login protection with Fail2Ban](/docs/guides/using-fail2ban-to-secure-your-server-a-tutorial/) as an additional security measure.
37+
{{% content "marketplace-required-limited-user-fields-shortguide" %}}
4938

5039
{{% content "marketplace-custom-domain-fields-shortguide" %}}
51-
- **SOA Email for your domain** The email address to register as your Start of Authority (SOA). This field is required for creating DNS records for a new domain.
52-
- **Do you need an MX record for this domain?** Select **Yes** to automatically configure an [MX record](/docs/guides/dns-overview/#mx) for the purpose of sending emails from your Linode. Additional configuration with Gitea is required after installation to enable sending emails with this app.
53-
- **Do you need an SPF record for this domain?** Select **Yes** to automatically configure an [SPF record](/docs/guides/dns-overview/#spf) for the purpose of sending emails from your Linode. Additional configuration with Gitea is required after installation to enable sending emails with this app.
54-
- **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`.
55-
- **Admin Email for Let's Encrypt certificate:** The email address to register with [Certbot](https://certbot.eff.org/) when generating an SSL certificate for your fully qualified domain name. This field is required for HTTPS access to your Gitea remote desktop.
56-
57-
{{% content "email-warning-shortguide" %}}
5840

5941
{{% content "marketplace-special-character-limitations-shortguide" %}}
6042

6143
## Getting Started after Deployment
6244

6345
### Access your Gitea Site
6446

65-
After Gitea has finished installing, you can access your Gitea site using a web browser to complete setup and begin using your app.
66-
67-
1. Enter your Linode's fully qualified domain name (for example, `https://www.example.com`) or [IPv4 address](/docs/products/compute/compute-instances/guides/manage-ip-addresses/) (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.
68-
69-
![The Gitea welcome page.](gitea-welcome-page.png 'Gitea welcome page')
70-
71-
1. Enter your [Gitea Database Password](#gitea-options) in the **Password** field.
72-
73-
![Gitea initial configuration settings.](initial-configuration-password.png 'Gitea initial configuration settings')
74-
75-
1. 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.
47+
With Gitea installed, you can access your Gitea site using a web browser to log in and begin using your app.
7648

77-
![Gitea general settings.](general-settings-domain-url.png 'Gitea general settings')
49+
To access the Gitea site:
7850

79-
1. Complete any other desired configurations, then select **Install Gitea** to complete initial configuration.
51+
1. In a browser, enter your Compute Instance's fully qualified domain name (for example, *ht<span>tp://</span>example.com*) or [Reverse DNS Address](https://techdocs.akamai.com/cloud-computing/docs/configure-rdns-reverse-dns-on-a-compute-instance).
8052

81-
1. 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](https://docs.gitea.io/).
53+
1. Click **Sign In**.
8254

55+
![The Gitea welcome page.](gitea-welcome-page.png 'Gitea welcome page')
8356

8457
## Software Included
8558

86-
The Gitea Marketplace App installs the following software on your Linode:
59+
The Gitea Marketplace App installs the following software on your Compute Instance:
8760

8861
| **Software** | **Description** |
8962
|:--------------|:------------|
9063
| [**Gitea**](https://gitea.io/) | Open source remote Git repository software. [v1.13.0](https://github.com/go-gitea/gitea/releases/tag/v1.13.0) |
91-
| [**MariaDB**](https://mariadb.org/) | Open source relational database fork of MySQL. |
64+
| [**PostgreSQL**](https://www.postgresql.org/) | Open source object-relational database system. |
9265
| [**NGINX**](https://www.nginx.com/) | Open source web server. Used as a reverse proxy by this app. See our guide on [Getting Started with NGINX](/docs/guides/getting-started-with-nginx-part-1-installation-and-basic-setup/) for more information. |
93-
| [**UFW**](https://wiki.ubuntu.com/UncomplicatedFirewall) | Firewall 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](/docs/guides/configure-firewall-with-ufw/) for instructions. |
66+
| [**UFW**](https://wiki.ubuntu.com/UncomplicatedFirewall) | Firewall 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 Compute Instance for use with this app. See our guide on [How to Configure a Firewall with UFW](/docs/guides/configure-firewall-with-ufw/) for instructions. |
9467

9568
{{% content "marketplace-update-note-shortguide" %}}
Binary file not shown.

0 commit comments

Comments
 (0)