# Install/Maintain/Configure

**URL:** https://forum.gitea.com/c/support/6.md

[Latest](https://forum.gitea.com/latest.md) · [Categories](https://forum.gitea.com/categories.md)

---

## [About the Install/Maintain/Configure category](https://forum.gitea.com/t/about-the-install-maintain-configure-category/17)

<div class="topic-metadata">

**Author:** [@gitea](https://forum.gitea.com/u/gitea)\
**Replies:** 0

</div>

For deployment/configuration problems. For any proposals or bugs, please go to Issues · go-gitea/gitea · GitHub.

---

## [How to change SSh git clone url?](https://forum.gitea.com/t/how-to-change-ssh-git-clone-url/7470)

<div class="topic-metadata">

**Author:** [@basil-ushakov](https://forum.gitea.com/u/basil-ushakov)\
**Replies:** 8\
**Last updated:** [October 23, 2026, 3:21pm UTC](https://forum.gitea.com/t/how-to-change-ssh-git-clone-url/7470 "2026-10-23T15:21:54Z")

</div>

Hello suggest, please, a solution. There is a gitea docker container with forwarded SSH port, 2222:22. How to change rendered git clone url for ssh from git@domain.com:username/demoproject.git to ssh://git@domain.c…

---

## [No longer able to mirror some Github repos: "migration/cloning from 'github.com' is not allowed"](https://forum.gitea.com/t/no-longer-able-to-mirror-some-github-repos-migration-cloning-from-github-com-is-not-allowed/12506)

<div class="topic-metadata">

**Author:** [@mingus](https://forum.gitea.com/u/mingus)\
**Replies:** 6\
**Last updated:** [October 18, 2026, 11:19pm UTC](https://forum.gitea.com/t/no-longer-able-to-mirror-some-github-repos-migration-cloning-from-github-com-is-not-allowed/12506 "2026-10-18T23:19:57Z")

</div>

I’ve been running the same instance of Gitea for a long while with no problems. Recently I upgraded my 1.26 to 28.0 and then 28.1 in quick succession. Now suddenly the handful of Github repos I mirror locally are getti…

---

## [Question regarding artifact retention policies in Gitea Actions](https://forum.gitea.com/t/question-regarding-artifact-retention-policies-in-gitea-actions/11824)

<div class="topic-metadata">

**Author:** [@padmakrishnadev](https://forum.gitea.com/u/padmakrishnadev)\
**Replies:** 2\
**Last updated:** [October 15, 2026, 8:44am UTC](https://forum.gitea.com/t/question-regarding-artifact-retention-policies-in-gitea-actions/11824 "2026-10-15T08:44:29Z")

</div>

Hi everyone, I am currently in the process of migrating a few workflows from GitLab CI to Gitea Actions, and I have a question regarding storage management. We are running Gitea via Docker Compose. I’ve successfully se…

---

## [Emplace LFS objects without Gitea API](https://forum.gitea.com/t/emplace-lfs-objects-without-gitea-api/12483)

<div class="topic-metadata">

**Author:** [@iAdjunct](https://forum.gitea.com/u/iAdjunct)\
**Replies:** 0\
**Last updated:** [October 6, 2026, 3:49am UTC](https://forum.gitea.com/t/emplace-lfs-objects-without-gitea-api/12483 "2026-10-06T03:49:20Z")

</div>

If I have a process external to Gitea (with access to the same gitea/lfs directory that Gitea is using) and I have it write (using the appropriate structure and naming scheme) an object into the file structure, is there …

---

## [Decrease LFS RAM Usage](https://forum.gitea.com/t/decrease-lfs-ram-usage/12482)

<div class="topic-metadata">

**Author:** [@iAdjunct](https://forum.gitea.com/u/iAdjunct)\
**Replies:** 0\
**Last updated:** [October 6, 2026, 3:41am UTC](https://forum.gitea.com/t/decrease-lfs-ram-usage/12482 "2026-10-06T03:41:51Z")

</div>

Is there any way to stop LFS from causing huge RAM spikes? I’ve had a gitea server for my dev for the last couple years with no issues at 768MB of RAM (in k8s). I’m now starting another project that’ll need LFS and, even…

---

## [Push failing when using reverse proxy (IIS) - could be oauth issue](https://forum.gitea.com/t/push-failing-when-using-reverse-proxy-iis-could-be-oauth-issue/12481)

<div class="topic-metadata">

**Author:** [@JadedAmber](https://forum.gitea.com/u/JadedAmber)\
**Replies:** 0\
**Last updated:** [October 1, 2026, 5:07pm UTC](https://forum.gitea.com/t/push-failing-when-using-reverse-proxy-iis-could-be-oauth-issue/12481 "2026-10-01T17:07:24Z")

</div>

Our server is sat behind an IIS reverse proxy, entirely within a local network. The IIS deals with https requests and just sends http requests to the server. Client is on the local network Fetch works, vscode can downl…

---

## [SSH key verification fails](https://forum.gitea.com/t/ssh-key-verification-fails/12429)

<div class="topic-metadata">

**Author:** [@Singlestone](https://forum.gitea.com/u/Singlestone)\
**Replies:** 2\
**Last updated:** [September 26, 2026, 2:08pm UTC](https://forum.gitea.com/t/ssh-key-verification-fails/12429 "2026-09-26T14:08:52Z")

</div>

I just installed Gitea 1.27.3 on Ubuntu 26.04. I’m trying to add an SSH key, but I can’t verify it. The command to generate the armored SSH signature works fine, but when I paste the text and hit the Verify button, I alw…

---

## [Unable to access Gitea via VPN](https://forum.gitea.com/t/unable-to-access-gitea-via-vpn/12331)

<div class="topic-metadata">

**Author:** [@newtothis](https://forum.gitea.com/u/newtothis)\
**Replies:** 2\
**Last updated:** [September 25, 2026, 1:40am UTC](https://forum.gitea.com/t/unable-to-access-gitea-via-vpn/12331 "2026-09-25T01:40:04Z")

</div>

Hi, I am an IT admin and have setup Gitea on a server. It can be accessed in local network, but it is not working via VPN. Port 3000 is also permitted in the firewall policy. Logs show that firewall is sending traffic …

---

## [Gitea Deployment Is Not Consistently Updating My Morse Code Website After Repository Changes](https://forum.gitea.com/t/gitea-deployment-is-not-consistently-updating-my-morse-code-website-after-repository-changes/12379)

<div class="topic-metadata">

**Author:** [@joeroot](https://forum.gitea.com/u/joeroot)\
**Replies:** 1\
**Last updated:** [September 9, 2026, 4:20am UTC](https://forum.gitea.com/t/gitea-deployment-is-not-consistently-updating-my-morse-code-website-after-repository-changes/12379 "2026-09-09T04:20:11Z")

</div>

I manage a Morse Code website that is hosted through a deployment workflow connected to a Gitea repository, and the site contains a JavaScript-based translator that converts text into Morse code and decodes Morse message…

---

## [504 Errors with Reverse Proxy in Docker](https://forum.gitea.com/t/504-errors-with-reverse-proxy-in-docker/12397)

<div class="topic-metadata">

**Author:** [@sageRJ](https://forum.gitea.com/u/sageRJ)\
**Replies:** 1\
**Last updated:** [August 31, 2026, 8:18pm UTC](https://forum.gitea.com/t/504-errors-with-reverse-proxy-in-docker/12397 "2026-08-31T20:18:19Z")

</div>

Are there any known issues running Gitea in a docker container behind a reverse proxy? For years we have experienced sporadic 504 errors that occur more often than not. We can’t seem to find any rhyme or reason to it. So…

---

## [Import from github export](https://forum.gitea.com/t/import-from-github-export/12392)

<div class="topic-metadata">

**Author:** [@delfick](https://forum.gitea.com/u/delfick)\
**Replies:** 3\
**Last updated:** [August 31, 2026, 6:40am UTC](https://forum.gitea.com/t/import-from-github-export/12392 "2026-08-31T06:40:33Z")

</div>

Hello, Github has the ability to export all your data I’m wondering if there’s anything anyone has already made that is able to migrate everything from that archive into gitea?

---

## [Gitea Installation on My Website Server Completes Successfully but the Web Interface Does Not Load Correctly](https://forum.gitea.com/t/gitea-installation-on-my-website-server-completes-successfully-but-the-web-interface-does-not-load-correctly/12383)

<div class="topic-metadata">

**Author:** [@joeroot](https://forum.gitea.com/u/joeroot)\
**Replies:** 2\
**Last updated:** [August 30, 2026, 6:34am UTC](https://forum.gitea.com/t/gitea-installation-on-my-website-server-completes-successfully-but-the-web-interface-does-not-load-correctly/12383 "2026-08-30T06:34:40Z")

</div>

Hello Gitea Community, I am currently facing one specific installation problem while setting up Gitea on the server that hosts my website. The installation process appears to complete successfully, and the required file…

---

## [EntraID SignIn Error: oauth2: error validating JWT token: user info JWT token is expired](https://forum.gitea.com/t/entraid-signin-error-oauth2-error-validating-jwt-token-user-info-jwt-token-is-expired/12361)

<div class="topic-metadata">

**Author:** [@Alexander](https://forum.gitea.com/u/Alexander)\
**Replies:** 7\
**Last updated:** [August 21, 2026, 7:09am UTC](https://forum.gitea.com/t/entraid-signin-error-oauth2-error-validating-jwt-token-user-info-jwt-token-is-expired/12361 "2026-08-21T07:09:44Z")

</div>

Hi, I’m new to Gitea and I’m really struggling to setup an instance on Windows with LetsEncrypt SSL certificate and Entra ID as authentication provider. By now I have a running instance on an English Windows Server 202…

---

## [Oauth EntraID with automatic user creation](https://forum.gitea.com/t/oauth-entraid-with-automatic-user-creation/12370)

<div class="topic-metadata">

**Author:** [@Alexander](https://forum.gitea.com/u/Alexander)\
**Replies:** 3\
**Last updated:** [August 21, 2026, 7:07am UTC](https://forum.gitea.com/t/oauth-entraid-with-automatic-user-creation/12370 "2026-08-21T07:07:21Z")

</div>

Hi, I’m new to Gitea and I’m really struggling to setup an instance on Windows with LetsEncrypt SSL certificate and Entra ID as authentication provider with automatic user creation. By now I have a running instance on …

---

## [Problems moving gitea instance to new server](https://forum.gitea.com/t/problems-moving-gitea-instance-to-new-server/6687)

<div class="topic-metadata">

**Author:** [@Rance](https://forum.gitea.com/u/Rance)\
**Replies:** 10\
**Last updated:** [August 20, 2026, 1:06pm UTC](https://forum.gitea.com/t/problems-moving-gitea-instance-to-new-server/6687 "2026-08-20T13:06:21Z")

</div>

I had to move my personal gitea instance to a new server. In doing so i had to change OSes and Gitea version (upgrade) – not my choice per se. copied the app.ini, db backup, and filestore to new server and the service …

---

## [Cleaning up orphaned attachments in S3 storage](https://forum.gitea.com/t/cleaning-up-orphaned-attachments-in-s3-storage/12332)

<div class="topic-metadata">

**Author:** [@leandrovip](https://forum.gitea.com/u/leandrovip)\
**Replies:** 1\
**Last updated:** [August 17, 2026, 1:31pm UTC](https://forum.gitea.com/t/cleaning-up-orphaned-attachments-in-s3-storage/12332 "2026-08-17T13:31:07Z")

</div>

Hi, I’m testing Gitea 1.27 with attachments stored in Backblaze B2. I uploaded a file to an issue comment, confirmed it was saved in the bucket, and then deleted the comment. The file is still in B2 afterwards. Is tha…

---

## [CORS setting defaults](https://forum.gitea.com/t/cors-setting-defaults/12337)

<div class="topic-metadata">

**Author:** [@AdamMajer](https://forum.gitea.com/u/AdamMajer)\
**Replies:** 1\
**Last updated:** [August 3, 2026, 3:28am UTC](https://forum.gitea.com/t/cors-setting-defaults/12337 "2026-08-03T03:28:56Z")

</div>

I notice that CORS and OAuth2 are independent options. OAuth2 provider is enabled by default. When OAuth2 is disabled, then users cannot register their own applications, so there is a functionality change. CORS, on othe…

---

## [Gitea + IIS + local domain](https://forum.gitea.com/t/gitea-iis-local-domain/12187)

<div class="topic-metadata">

**Author:** [@fgo](https://forum.gitea.com/u/fgo)\
**Replies:** 2\
**Last updated:** [July 27, 2026, 2:04am UTC](https://forum.gitea.com/t/gitea-iis-local-domain/12187 "2026-07-27T02:04:20Z")

</div>

Hello, Gitea shows the message: “The detected web site URL is “http://192.168.(…):3000/”, it’s unlikely matching the site config. Mismatched app.ini ROOT\_URL or reverse proxy “Host/X-Forwarded-Proto” config might caus…

---

## [Self-host auto generated pages](https://forum.gitea.com/t/self-host-auto-generated-pages/12306)

<div class="topic-metadata">

**Author:** [@Elikill58](https://forum.gitea.com/u/Elikill58)\
**Replies:** 1\
**Last updated:** [July 17, 2026, 6:33pm UTC](https://forum.gitea.com/t/self-host-auto-generated-pages/12306 "2026-07-17T18:33:27Z")

</div>

Hello, I have auto generated static HTML file (documentation) that I want to make it easy to see. Is that possible to host it on gitea directly ?

---

## [Cannot get LDAPS to work](https://forum.gitea.com/t/cannot-get-ldaps-to-work/12304)

<div class="topic-metadata">

**Author:** [@Gaetan](https://forum.gitea.com/u/Gaetan)\
**Replies:** 2\
**Last updated:** [July 8, 2026, 9:20am UTC](https://forum.gitea.com/t/cannot-get-ldaps-to-work/12304 "2026-07-08T09:20:43Z")

</div>

Hello, I have installed Gitea 1.24.5, it is running fine but I cannot get it to synchronize with my Active Directory using LDAPS. When I try to log in with an AD user, I get “Username or password is incorrect”. Here’s …

---

## [Repository size not reduced after git-filter-repo](https://forum.gitea.com/t/repository-size-not-reduced-after-git-filter-repo/12285)

<div class="topic-metadata">

**Author:** [@Zerowalker](https://forum.gitea.com/u/Zerowalker)\
**Replies:** 0\
**Last updated:** [June 26, 2026, 5:32am UTC](https://forum.gitea.com/t/repository-size-not-reduced-after-git-filter-repo/12285 "2026-06-26T05:32:48Z")

</div>

I have used git-filter-repo to remove 2 large files, and can confirm that locally the .git is reduced. then I force push and it all works fine. However the size doesn’t reduce, it’s still more or less the same. I saw …

---

## [Error 0A000126 when mirroring to Codeberg](https://forum.gitea.com/t/error-0a000126-when-mirroring-to-codeberg/12281)

<div class="topic-metadata">

**Author:** [@gavd](https://forum.gitea.com/u/gavd)\
**Replies:** 8\
**Last updated:** [June 24, 2026, 3:31am UTC](https://forum.gitea.com/t/error-0a000126-when-mirroring-to-codeberg/12281 "2026-06-24T03:31:20Z")

</div>

Good morning. I’m running a self‑hosted Gitea instance in a Docker container on my server. One of my repositories has a Mirror Configuration enabled to sync with an external repository on Codeberg (https://codeberg.org).…

---

## [Packfile not found](https://forum.gitea.com/t/packfile-not-found/2728)

<div class="topic-metadata">

**Author:** [@yoyodyn](https://forum.gitea.com/u/yoyodyn)\
**Replies:** 2\
**Last updated:** [June 18, 2026, 10:36pm UTC](https://forum.gitea.com/t/packfile-not-found/2728 "2026-06-18T22:36:54Z")

</div>

Getting error 500 when trying to get to one repo on the server. All the other repos appear to be fine. This used to only happen when trying to view the “branches” but now can’t bring up the repo at all through the web …

---

## [Unable to clone via ssh](https://forum.gitea.com/t/unable-to-clone-via-ssh/12264)

<div class="topic-metadata">

**Author:** [@ptrsdwski](https://forum.gitea.com/u/ptrsdwski)\
**Replies:** 1\
**Last updated:** [June 14, 2026, 2:40am UTC](https://forum.gitea.com/t/unable-to-clone-via-ssh/12264 "2026-06-14T02:40:14Z")

</div>

I’m having some issues push/pull/clone with my ssh key and I’m not sure where else I’m supposed to look for troubleshooting. I’m running Gitea 1.26.2 in a docker container with ssh forwarded to port 222. I’ve uploaded …

---

## [Issues with authentication pushing rust crate](https://forum.gitea.com/t/issues-with-authentication-pushing-rust-crate/12257)

<div class="topic-metadata">

**Author:** [@forgiteasoup](https://forum.gitea.com/u/forgiteasoup)\
**Replies:** 0\
**Last updated:** [June 10, 2026, 1:52pm UTC](https://forum.gitea.com/t/issues-with-authentication-pushing-rust-crate/12257 "2026-06-10T13:52:42Z")

</div>

Problem cannot push a rust crate to package registry in organization (or simple user) fails with “split token failed” fails with both sparse and git indexes fails with package read/write token and a completely stacked r…

---

## [Reverse proxy on non-standard port](https://forum.gitea.com/t/reverse-proxy-on-non-standard-port/12256)

<div class="topic-metadata">

**Author:** [@richardh](https://forum.gitea.com/u/richardh)\
**Replies:** 0\
**Last updated:** [June 10, 2026, 7:22am UTC](https://forum.gitea.com/t/reverse-proxy-on-non-standard-port/12256 "2026-06-10T07:22:09Z")

</div>

Hi, Our gitea has been running fine with nginx listening on port 8443, and with that port included in ROOT\_URL in app.ini. Now the clone urls are generated without that port. This seems to have changed with the upgrade …

---

## [SSH something is broken and it's a real shame](https://forum.gitea.com/t/ssh-something-is-broken-and-its-a-real-shame/12235)

<div class="topic-metadata">

**Author:** [@fergusd](https://forum.gitea.com/u/fergusd)\
**Replies:** 3\
**Last updated:** [June 7, 2026, 2:34pm UTC](https://forum.gitea.com/t/ssh-something-is-broken-and-its-a-real-shame/12235 "2026-06-07T14:34:54Z")

</div>

Hi, Having followed various sets of instructions to install a containerised gitea and postgres setup I cannot get ssh access to work. There is a load of perhaps, maybe type commentary on this, but it doesn’t help. I c…

---

## [Logout redirect issues after upgrading to 1.26](https://forum.gitea.com/t/logout-redirect-issues-after-upgrading-to-1-26/12083)

<div class="topic-metadata">

**Author:** [@OCram85](https://forum.gitea.com/u/OCram85)\
**Replies:** 1\
**Last updated:** [May 26, 2026, 7:15am UTC](https://forum.gitea.com/t/logout-redirect-issues-after-upgrading-to-1-26/12083 "2026-05-26T07:15:18Z")

</div>

Hey folks, just noticed a weird behavior after upgrading to 1.26: We use authentik to manage the users and deploy them to gitea. So Gitea identifies these users correctly with ‘Authentication Source: ..some external ID…

---

## [Group Mapping with Authentik not working](https://forum.gitea.com/t/group-mapping-with-authentik-not-working/12134)

<div class="topic-metadata">

**Author:** [@Gitter](https://forum.gitea.com/u/Gitter)\
**Replies:** 0\
**Last updated:** [May 25, 2026, 2:43pm UTC](https://forum.gitea.com/t/group-mapping-with-authentik-not-working/12134 "2026-05-25T14:43:22Z")

</div>

Hi! I’ve sucessfully setup Authentik (latest version) and Gitea (latest version, Docker container) to allow new users to sign up to Gitea. This works already flawlessly. However, mapping Authentik users (or groups) to …

[Next page](https://forum.gitea.com/c/support/6.md?page=1)
