Files
Gogs/docs/getting-started/introduction.mdx
2026-02-07 18:19:02 -05:00

129 lines
3.3 KiB
Plaintext

---
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>