Accessing Your Settings
Click your avatar in the top-right corner of any page and select Settings to access your account configuration.
Profile Settings
- Display Name — The name shown on your profile and in comments.
- Bio — A short description visible on your profile page.
- Avatar — Upload a custom profile image or use a Gravatar.
- Website & Location — Optional fields for your personal or company website.
Account Security
Changing Your Password
- Go to Settings → Account.
- Enter your current password and your new password.
- Click Update Password.
Two-Factor Authentication (2FA)
For added security, enable 2FA under Settings → Security:
- Click Enroll under Two-Factor Authentication.
- Scan the QR code with an authenticator app (e.g., Google Authenticator, Authy).
- Enter the verification code to confirm.
- Save your recovery codes in a secure location.
Email Settings
Manage your email addresses under Settings → Account. You can:
- Add multiple email addresses.
- Set a primary email for notifications and Git commits.
- Keep your email private by enabling the Keep Email Address Private option.
Notifications
Control how you receive notifications under Settings → Notifications. MokoGitea can notify you via email when:
- You're mentioned in an issue or pull request.
- A repository you watch has new activity.
- A pull request you're reviewing is updated.
API Tokens
Generate personal access tokens for automation and third-party integrations:
- Go to Settings → Applications.
- Enter a Token Name and select the required permissions.
- Click Generate Token.
- Copy the token immediately — it won't be shown again.
Use these tokens for CI/CD pipelines, API scripts, or any tool that needs to authenticate with MokoGitea.