forgejo/README.md

<div align="center">
    <img src="./assets/logo.svg" alt="" width="192" align="center" />
    <h1 align="center">Welcome to Forgejo</h1>
</div>

Hi there! Tired of big platforms playing monopoly?
Providing Git hosting for your project, friends, company or community?
**Forgejo** (/for'd&#865;ʒe.jo/ inspired by forĝejo – the Esperanto word for *forge*) has you covered with its intuitive interface,
light and easy hosting and a lot of builtin functionality.

Forgejo was [created in 2022](https://forgejo.org/2022-12-15-hello-forgejo/)
because we think that the project should be owned by an independent community.
If you second that, then Forgejo is for you!
Our promise: **Independent Free/Libre Software forever!**

## What does Forgejo offer?

<!-- If you want to know what Forgejo is like,
you can check out public instances,
e.g. [Codeberg.org](https://codeberg.org).
-->

If you like any of the following, Forgejo is literally meant for you:

- Lightweight: Forgejo can easily be hosted on nearly **every machine**.
  Running on a Raspberry? Small cloud instance? No problem!
- Project management: Besides Git hosting, Forgejo offers issues,
  pull requests, wikis, kanban boards and much more to **coordinate with your team**.
- Publishing: Have something to share? Use **releases** to host your software for download,
  or use the **package registry** to publish it for docker, npm and many other package managers.
- Customizable: Want to change your look? Change some settings?
  There are many **config switches** to make Forgejo work exactly like you want.
- Powerful: Organizations & team permissions, CI integration, Code Search, LDAP, OAuth and much more.
  If you have **advanced needs**, Forgejo has you covered.
- Privacy: From update checker to default settings: Forgejo is built to be **privacy first** for you and your crew.
- Federation: (WIP) We are actively working to connect software forges with each other through **ActivityPub**,
  and create a collaborative network of personal instances.

## Learn more

Dive into the [documentation](https://forgejo.org/docs/latest/), subscribe to releases and blog post on [our website](https://forgejo.org), <a href="https://floss.social/@forgejo" rel="me">find us on the Fediverse</a> or hop into [our Matrix room](https://matrix.to/#/#forgejo-chat:matrix.org) if you have any questions or want to get involved.


## Get involved

If you are interested in making Forgejo better, either by reporting a bug or by changing the governance, please [take a look at the contribution guide](CONTRIBUTING.md).
-												[DOCS] README

(cherry picked from commit a47b4745861ba2ab7485974d27334aed44feeac3)
(cherry picked from commit 2fcc61c1d929380884dd9aeb143c202a2be0eef9)
(cherry picked from commit 67debe2247c83753173efba53c60845f522857b5)
(cherry picked from commit b90ffbb309bc76968588a024d2ced081989295ea)
(cherry picked from commit 07a744814855a8bcb8d196c6c31f9bde7cfcf249)
(cherry picked from commit a7fe270c08c25e6db42c32019b4a1a0720a57ec1)
(cherry picked from commit 2f15389a9cafa00001c84396a1a88a14c3250e5c)
(cherry picked from commit 16ba587f5dbbfa36398ca55e5210e5233211e224)
(cherry picked from commit 683a23b2ca29f3638a2bd703dad567ae2896f261)
(cherry picked from commit 3e5de3f656fa769317bf1cd1e508682f89e90000)
(cherry picked from commit 5789005c4355f9d6b76a2288376b3b45a7939ba0)
(cherry picked from commit 75c0f11079bc1e376b55186c4994bea71a54cd15)
(cherry picked from commit e78a272e111066950ad5a365e504e1aacb4de5b7)
(cherry picked from commit 464a534a3a712111b5578523bb657cd36cb10f64)
(cherry picked from commit 7c0b73ca6fc28696fd580d7f858f8d814436e9a6)
(cherry picked from commit e66b8edbc6fa1120ea4e66d586ea46c06a865a05)
(cherry picked from commit a91864340d75d16e6afce18e7e5b974cfae8719f)
(cherry picked from commit 504905bc882ad075f821fb4fcd86560191bdada9)
(cherry picked from commit 650137433f44d65570947c8dbad6fb51b18f8a68)
(cherry picked from commit 3e00bdaf2a2d47d168108cd130829d6d864fa4b4)
(cherry picked from commit 43efcc1a29449c802b18a09387af67c24e71b189)
(cherry picked from commit 4984ba13c57fdade1a5744713c98a60e650a5b9a)
(cherry picked from commit 02b7928710ad9446b93598801dff0afae828136a)
(cherry picked from commit 0db0feaee25187bcd4c28c9e66d3d0eabaad7a8d)
(cherry picked from commit 94d141bc7f488ab0e6512218cac409b63cf83700)
(cherry picked from commit 392fb1589178338b8285df7b348754e79611590e)
(cherry picked from commit c5699a7bb71962321b131c9ac4413f8710de0d56)
(cherry picked from commit b975597a781c745463d9db80a220733d99a12e28)
(cherry picked from commit 5395e74d72285490f25067c8ac72899a3e23f3e7)
(cherry picked from commit bc8060dee4355667680dab8935a7abd504ceefbd)
(cherry picked from commit 3b64f1477a50319c3dbf638c89ef04dbd2fc12af)
(cherry picked from commit d40378e1c767194b2207d359378a976f1f0c9090)
(cherry picked from commit a713f7e3f9f6f8231d2cba82833d8eabec8b0dd4)
(cherry picked from commit 87f65ccf78eb19e573971c8c16a76f60d610a5d5)
(cherry picked from commit 049ea571a90853cb9bc1ce054313055884f76513)
(cherry picked from commit 433d1d7baae7e72b32b8d2febdf0bf01d925bbf3)
(cherry picked from commit 21bed2af1de216304dac33c33865bb70e31e416d)
(cherry picked from commit fe700ca4015e62d83b40ed5409de023ab8959f4c)
(cherry picked from commit 2f5c0479a9ca2f779c5feed1abb32aad4fc62cd0)
(cherry picked from commit f7afcdba8a4fb1e6f60ec3c2d6ffb256d6f3413f)
(cherry picked from commit 323e99d9f5c2526b332748da2802c3b5d4f54bc7)
(cherry picked from commit aa6a3edf2f0de500c417b1a82c804fe74ef46757)
(cherry picked from commit 754a8b4b305e3f6656ada4898ed0eaa987cfc7c8)
(cherry picked from commit 52f173647a77a9ed4252472618cbcfa74254618a)
(cherry picked from commit 559dcf0ccf96f0562f9015e692de56747eaa30f1)
(cherry picked from commit 393f09eaf9e31dd6471623f21eb1cba0070ef325)
(cherry picked from commit a3eb61aef38190b3f3d343decc1985c5a9dadd69)
(cherry picked from commit 8d5277a7e1913b9dc2941553c657dadea499aa99)
(cherry picked from commit 265be677fbf281f4d7119a6e00ce26ea3f7dada2)

											
										
										
											2022-12-17 13:06:57 +00:00
+								<div align="center">
-												[BRANDING] add Forgejo logo

(cherry picked from commit f42622c7d5a28859f535e0d86ece06101baad1ef)
(cherry picked from commit a39e7f2a79f6527d45439f21bd88378264160c3a)
(cherry picked from commit afa2a31bb99c0fd9cd25c3c0279e6c49695b1900)
(cherry picked from commit 276e8856e594ad7e73414382d34fdf0278cbca6a)
(cherry picked from commit 68e3bd469f2e8190db70d4e1564fb46d01feb5f4)
(cherry picked from commit af124b9ccbb0b699ea5d1bf1530613cb9a96f205)
(cherry picked from commit b89ab4874d403c784c92e579f4f6a854621c0078)
(cherry picked from commit 0f2a2f0d0ff9851428d6899e307f3547d7651f87)
(cherry picked from commit 80999363c73e4e01cbf9116491743c87baa952af)
(cherry picked from commit f8880b5463aa1db047d89080d21e7a69979eb4a6)
(cherry picked from commit 5f4cf4f6e143237c81da3e80875727cef4b76343)
(cherry picked from commit b38e26bc1a8bb117f571672961a8445cfc02c953)
(cherry picked from commit d839e0033244b63df16c8b548cc52106fc693629)
(cherry picked from commit 32ffe2e4f12c16a44a759c906078d40731c1a0c7)
(cherry picked from commit f1fd0504add78ae3fb5c710ab5a9ada20321afac)
(cherry picked from commit 6d77ea4d60a193d9d4175c4943b34077228e5964)
(cherry picked from commit 61a0a4a276303c3fd56f93fd109e3416cfdf7c60)
(cherry picked from commit a90b4126fdd55feef43f45d1dc3e3400806a476b)
(cherry picked from commit 9a20538fb4e88682e213a20813b77cc0f602fbfd)
(cherry picked from commit ce0fc02f0fbaa45b146fed175ce68bd02c507f3e)
(cherry picked from commit 541f7cb026f976d078ecb6da3a6c9e13cc4336f2)
(cherry picked from commit d6d0c2ab78a14d7aac8d7b6b0d007149de2f7295)
(cherry picked from commit 2c28f5ad2496cf30eb15d6caf9171b79e5017141)
(cherry picked from commit 9571bddb3308e3c1f0383e60f972ca61a0a467b7)
(cherry picked from commit c83ba08d01f149ecd52d983eec76bd60822c1ddd)
(cherry picked from commit 30e7d567ede79c015d0d115d9a2d535e6c681cb9)
(cherry picked from commit a8b8c3eba75511449dc97fa27b37db1076ce95f0)
(cherry picked from commit 8e053e1ade4710ade3b6e4bc6aa04fe9281243d7)
(cherry picked from commit 9e3b0f7520a56e5eb22cd0e33e231ea9063f0e1f)
(cherry picked from commit 2343b9bd09cda3e474b36842fae419f9fe32b134)
(cherry picked from commit 56572d4156050c2beb62f63a871375fdc2424271)
(cherry picked from commit 9b09eda1680282f8114f752e52afd544ef30350c)
(cherry picked from commit 86a8b7b4904158ea80d259d7a1846528a9b3c403)
(cherry picked from commit 99a550c0e3de3bd8d17a610b849da0c04f776dbd)
(cherry picked from commit bdcf3f51e07c9f5f067fca7501ad69c42f925197)
(cherry picked from commit cec8f2d31e1cd9237120ee57af80b17e4abf026e)
(cherry picked from commit 25aa22ba2b8b8bdb215c14002ebc137e2e70cad4)
(cherry picked from commit 31510249a01fad40cc001277f5bcbe57248b0330)
(cherry picked from commit 95dc569227ac57c2efe7817edb6749fcead0ec24)
(cherry picked from commit f6caf5f1b9f8f560fcfef29247525c018976dcde)
(cherry picked from commit aba34fbf70dce183907083593cab7716597575a3)
(cherry picked from commit 41b816fdac30cfca311d5c24c155301de5d08a40)
(cherry picked from commit c98e79b89f5a12b50b6eb1ff1d0afc2cbd756ca3)
(cherry picked from commit d33d4f193cd79493e3d206e0c73395aea5bd305c)
(cherry picked from commit 4e5bb41cbe9823f8c198a54b56f0ee66b9cf8bf8)
(cherry picked from commit 3aa8ddb8cb4cb836b98c465342b106d027868606)
(cherry picked from commit e8057040bb751d1bdcb0e7412495da353189a02f)
(cherry picked from commit f3bf61e51e8c44ac098dca03532507bae5b65fc1)
(cherry picked from commit e9d08aad76cc38a81e9489871e1116819f84052e)

											
										
										
											2022-12-17 10:20:38 +00:00
+								    <img src="./assets/logo.svg" alt="" width="192" align="center" />
-												[DOCS] README

(cherry picked from commit a47b4745861ba2ab7485974d27334aed44feeac3)
(cherry picked from commit 2fcc61c1d929380884dd9aeb143c202a2be0eef9)
(cherry picked from commit 67debe2247c83753173efba53c60845f522857b5)
(cherry picked from commit b90ffbb309bc76968588a024d2ced081989295ea)
(cherry picked from commit 07a744814855a8bcb8d196c6c31f9bde7cfcf249)
(cherry picked from commit a7fe270c08c25e6db42c32019b4a1a0720a57ec1)
(cherry picked from commit 2f15389a9cafa00001c84396a1a88a14c3250e5c)
(cherry picked from commit 16ba587f5dbbfa36398ca55e5210e5233211e224)
(cherry picked from commit 683a23b2ca29f3638a2bd703dad567ae2896f261)
(cherry picked from commit 3e5de3f656fa769317bf1cd1e508682f89e90000)
(cherry picked from commit 5789005c4355f9d6b76a2288376b3b45a7939ba0)
(cherry picked from commit 75c0f11079bc1e376b55186c4994bea71a54cd15)
(cherry picked from commit e78a272e111066950ad5a365e504e1aacb4de5b7)
(cherry picked from commit 464a534a3a712111b5578523bb657cd36cb10f64)
(cherry picked from commit 7c0b73ca6fc28696fd580d7f858f8d814436e9a6)
(cherry picked from commit e66b8edbc6fa1120ea4e66d586ea46c06a865a05)
(cherry picked from commit a91864340d75d16e6afce18e7e5b974cfae8719f)
(cherry picked from commit 504905bc882ad075f821fb4fcd86560191bdada9)
(cherry picked from commit 650137433f44d65570947c8dbad6fb51b18f8a68)
(cherry picked from commit 3e00bdaf2a2d47d168108cd130829d6d864fa4b4)
(cherry picked from commit 43efcc1a29449c802b18a09387af67c24e71b189)
(cherry picked from commit 4984ba13c57fdade1a5744713c98a60e650a5b9a)
(cherry picked from commit 02b7928710ad9446b93598801dff0afae828136a)
(cherry picked from commit 0db0feaee25187bcd4c28c9e66d3d0eabaad7a8d)
(cherry picked from commit 94d141bc7f488ab0e6512218cac409b63cf83700)
(cherry picked from commit 392fb1589178338b8285df7b348754e79611590e)
(cherry picked from commit c5699a7bb71962321b131c9ac4413f8710de0d56)
(cherry picked from commit b975597a781c745463d9db80a220733d99a12e28)
(cherry picked from commit 5395e74d72285490f25067c8ac72899a3e23f3e7)
(cherry picked from commit bc8060dee4355667680dab8935a7abd504ceefbd)
(cherry picked from commit 3b64f1477a50319c3dbf638c89ef04dbd2fc12af)
(cherry picked from commit d40378e1c767194b2207d359378a976f1f0c9090)
(cherry picked from commit a713f7e3f9f6f8231d2cba82833d8eabec8b0dd4)
(cherry picked from commit 87f65ccf78eb19e573971c8c16a76f60d610a5d5)
(cherry picked from commit 049ea571a90853cb9bc1ce054313055884f76513)
(cherry picked from commit 433d1d7baae7e72b32b8d2febdf0bf01d925bbf3)
(cherry picked from commit 21bed2af1de216304dac33c33865bb70e31e416d)
(cherry picked from commit fe700ca4015e62d83b40ed5409de023ab8959f4c)
(cherry picked from commit 2f5c0479a9ca2f779c5feed1abb32aad4fc62cd0)
(cherry picked from commit f7afcdba8a4fb1e6f60ec3c2d6ffb256d6f3413f)
(cherry picked from commit 323e99d9f5c2526b332748da2802c3b5d4f54bc7)
(cherry picked from commit aa6a3edf2f0de500c417b1a82c804fe74ef46757)
(cherry picked from commit 754a8b4b305e3f6656ada4898ed0eaa987cfc7c8)
(cherry picked from commit 52f173647a77a9ed4252472618cbcfa74254618a)
(cherry picked from commit 559dcf0ccf96f0562f9015e692de56747eaa30f1)
(cherry picked from commit 393f09eaf9e31dd6471623f21eb1cba0070ef325)
(cherry picked from commit a3eb61aef38190b3f3d343decc1985c5a9dadd69)
(cherry picked from commit 8d5277a7e1913b9dc2941553c657dadea499aa99)
(cherry picked from commit 265be677fbf281f4d7119a6e00ce26ea3f7dada2)

											
										
										
											2022-12-17 13:06:57 +00:00
+								    <h1 align="center">Welcome to Forgejo</h1>
 								</div>
 								Hi there! Tired of big platforms playing monopoly?
 								Providing Git hosting for your project, friends, company or community?
 								**Forgejo** (/for'd&#865;ʒe.jo/ inspired by forĝejo – the Esperanto word for *forge*) has you covered with its intuitive interface,
 								light and easy hosting and a lot of builtin functionality.
 								Forgejo was [created in 2022](https://forgejo.org/2022-12-15-hello-forgejo/)
 								because we think that the project should be owned by an independent community.
 								If you second that, then Forgejo is for you!
 								Our promise: **Independent Free/Libre Software forever!**
 								## What does Forgejo offer?
 								<!-- If you want to know what Forgejo is like,
 								you can check out public instances,
 								e.g. [Codeberg.org](https://codeberg.org).
 								-->
 								If you like any of the following, Forgejo is literally meant for you:
 								- Lightweight: Forgejo can easily be hosted on nearly **every machine**.
 								  Running on a Raspberry? Small cloud instance? No problem!
 								- Project management: Besides Git hosting, Forgejo offers issues,
 								  pull requests, wikis, kanban boards and much more to **coordinate with your team**.
 								- Publishing: Have something to share? Use **releases** to host your software for download,
 								  or use the **package registry** to publish it for docker, npm and many other package managers.
 								- Customizable: Want to change your look? Change some settings?
 								  There are many **config switches** to make Forgejo work exactly like you want.
 								- Powerful: Organizations & team permissions, CI integration, Code Search, LDAP, OAuth and much more.
 								  If you have **advanced needs**, Forgejo has you covered.
 								- Privacy: From update checker to default settings: Forgejo is built to be **privacy first** for you and your crew.
 								- Federation: (WIP) We are actively working to connect software forges with each other through **ActivityPub**,
 								  and create a collaborative network of personal instances.
 								## Learn more
 								Dive into the [documentation](https://forgejo.org/docs/latest/), subscribe to releases and blog post on [our website](https://forgejo.org), <a href="https://floss.social/@forgejo" rel="me">find us on the Fediverse</a> or hop into [our Matrix room](https://matrix.to/#/#forgejo-chat:matrix.org) if you have any questions or want to get involved.
 								## Get involved
 								If you are interested in making Forgejo better, either by reporting a bug or by changing the governance, please [take a look at the contribution guide](CONTRIBUTING.md).