gogs/docs/getting-started/introduction.mdx

---
title: "Introduction"
sidebarTitle: "Introduction"
description: "The painless way to host your own Git service"
icon: "book-open"
---

<img
  className="block dark:hidden"
  src="/images/logo-light.svg"
  noZoom
/>

<img
  className="hidden dark:block"
  src="/images/logo-dark.svg"
  noZoom
/>

## Vision

The Gogs project aims to build a simple, stable and extensible self-hosted Git service that can be set up in the most painless way. With Go, this can be done with an independent binary distribution across all platforms that Go supports, including Linux, macOS, Windows and ARM-based systems.

## Core values

- **Simple to install**: Run the binary, or run as a Docker container.
- **Cross-platform**: Runs on every platform that Go toolchain supports.
- **Lightweight**: Unrealistically low resource consumption to get started. Only got 64 MiB of RAM and a quarter of vCPU? No problem!
- **Open source**: MIT-licensed since 2014, all source code available in public.

## Sponsors

The growth of the Gogs project wasn't possible without our world-class sponsors! <Icon icon="heart" iconType="solid" color="#e25555" />

<Columns cols={2}>
  <a href="https://www.digitalocean.com/?refcode=5aeb02268b55&utm_campaign=Referral_Invite&utm_medium=Referral_Program&utm_source=badge" target="_blank" style={{borderBottom: "none"}}>
    <img
      className="block dark:hidden"
      src="/images/sponsors/digitalocean-light.png"
      width={320}
      noZoom
    />
    <img
      className="hidden dark:block"
      src="/images/sponsors/digitalocean-dark.png"
      width={320}
      noZoom
    />
  </a>

  <a href="https://www.mintlify.com" target="_blank" style={{borderBottom: "none"}}>
    <img
      className="block dark:hidden"
      src="/images/sponsors/mintlify-light.svg"
      width={320}
      noZoom
    />
    <img
      className="hidden dark:block"
      src="/images/sponsors/mintlify-dark.svg"
      width={320}
      noZoom
    />
  </a>

  <a href="https://www.crowdin.com" target="_blank" style={{borderBottom: "none"}}>
    <img
      className="block dark:hidden"
      src="/images/sponsors/crowdin-light.svg"
      width={320}
      noZoom
    />
    <img
      className="hidden dark:block"
      src="/images/sponsors/crowdin-dark.svg"
      width={320}
      noZoom
    />
  </a>

  <a href="https://www.buildkite.com" target="_blank" style={{borderBottom: "none", paddingTop: "5px"}}>
    <img
      className="block dark:hidden"
      src="/images/sponsors/buildkite-light.svg"
      width={320}
      noZoom
    />
    <img
      className="hidden dark:block"
      src="/images/sponsors/buildkite-dark.svg"
      width={320}
      noZoom
    />
  </a>
</Columns>

## Quickstart

<CardGroup cols={2}>
  <Card
    title="Installation"
    icon="download"
    href="/getting-started/installation"
  >
    Get your own Git service up and running in minutes.
  </Card>
  <Card
    title="Configuration"
    icon="gear"
    href="/fine-tuning/configuration-primer"
  >
    Fine tune your instance exactly the way you want.
  </Card>
  <Card
    title="Features"
    icon="star"
    href="/advancing/authentication"
  >
    Discover powerful and advanced features.
  </Card>
  <Card
    title="Upgrade"
    icon="arrow-up"
    href="/asking/release-strategy"
  >
    Keep up the version and energy.
  </Card>
</CardGroup>