mirrors/GitNex
1
0
Fork 0
mirror of https://codeberg.org/gitnex/GitNex.git synced 2024-12-16 15:48:13 +08:00
Code Issues Actions Packages Projects Releases Wiki Activity

Update 'Troubleshoot Guide'

M M Arif 2023-05-12 17:43:29 +00:00
parent fab8b080c8
commit d4864c479d
1 changed files with 8 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

16
Troubleshoot-Guide.md

@ -1,39 +1,39 @@
**Here you will find the most common hacks to use the app.**
### I have HTTP basic authentication enabled at proxy level with pass thru. How to login?
## I have HTTP basic authentication enabled at proxy level with pass thru. How to login?
On the login screen in the URL field enter `YOUR-USERNAME@YOUR-DOMAIN.COM` and skip the username field to fill. This will let you login to the app. For example, `gitnex@try.gitea.io`
**Please note, that your proxy level username and password should be the same with your Forgejo or Gitea logins.**
This feature is available in **GitNex version 1.2.0** and above.
### I have enabled 2FA for my account and I am on 1.8.0 Gitea version. How to login?
## I have enabled 2FA for my account and I am on 1.8.0 Gitea version. How to login?
**If you are on GitNex version 1.4.0 or below:**
On the login screen in the Username field enter `YOUR-USERNAME:OTP`, `:` is the separator between username and otp code. For example, `gitnex:251364`
**If you are on GitNex version 1.5.0 or above:**
A separate optional field is introduced to enter the OTP code if you have enabled 2FA for your account.
### I cannot login and the app just stuck at the login screen.
## I cannot login and the app just stuck at the login screen.
**SSL Certificate:**
Make sure you have a valid ssl certificate for your domain with port 443. If you have a valid SSL certificate but different port, it will be mismatched and **GitNex version 2.5.0** only support this.
**I have self signed certificate, what to do?**
Self signed certificates are only supported from version **2.5.0**. Make sure you have this version installed.
### The app crash when I am browsing around.
## The app crash when I am browsing around.
1. Update to the latest version of **GitNex**.
2. If this does not solve the issue, you can always test the dev version from main branch. Chances are it may have been fixed. You can download the latest signed build from [main](https://codeberg.org/gitnex/GitNex#user-content-downloads) to test.
3. No, still does not work. We appreciate that you open an issue and provide as much detail possible.
### What version of Android do you guys test the app on?
## What version of Android do you guys test the app on?
We normally test a release on Android 9 and above. If you have Android 6, 7 and there is an issue with the app, please let us know so we can test on that version and help fix the problem. Opening an issue is a [step away](https://codeberg.org/gitnex/GitNex/issues).
### "No instance detected", why I am getting this message?
## "No instance detected", why I am getting this message?
If you have compiled Forgejo or Gitea and the version format is not like `1.12.3` etc and instead it resemble the commit hash `dhsb82g2`. You will need to recompile Forgejo or Gitea again with proper and correct version. Check out our discord channel or Forgejo or Gitea cheat sheet for more details. To know your Forgejo or Gitea version, type in browser `https://YOUR-DOMAIN/api/v1/version`. Change `https://YOUR-DOMAIN` to the actual IP or domain.
### I cannot browse directories inside file browser.
## I cannot browse directories inside file browser.
Make sure your proxy web server is setup properly, check this [link](https://docs.gitea.io/en-us/reverse-proxies/#apache-httpd) for Apache. If still encounter issues, open an [issue](https://codeberg.org/gitnex/GitNex/issues/new/choose).
### I am using Gitea/Forgejo version 1.19 or above. Which token scopes should I select when creating an application token?
## I am using Gitea/Forgejo version 1.19 or above. Which token scopes should I select when creating an application token?
For optimal results, it is recommended that you choose all available scopes. GitNex adds new features with each release, and there may come a time when your token with limited scope access will prevent you from using a function or feature. Therefore, selecting all scopes is advised.