You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
Johannes Frohnmeyer e5964ae13a
Fix comment label
2 months ago
src/main Support for ignoring mails 2 months ago
templates/repo/issue Fix comment label 2 months ago
.gitignore Untested initial impl 5 months ago
LICENSE Add additional details on deployment 5 months ago
README.md Add custom templates and webpage for posting replies 5 months ago
build.gradle.kts Add additional details on deployment 5 months ago
settings.gradle.kts Untested initial impl 5 months ago

README.md

Gitea-Helpdesk

Gitea-Helpdesk is an extension to Gitea that allows users to create issues through emails, comment on existing ones and receiving notifications for new comments. To do so, it must be connected to a postgresql database, a gitea instance and a mail server (pop3+smtp). The mail server MUST support sub-addressing with + and the repository name and gitea username must match [a-zA-Z0-9-_]+. To set up the service, build a jar and add a config file as follows to the current directory:

{
  "gitea": {
    "host": "https://gitea.example.com", // Your gitea instance 
    "token": "0123456789abcdef0123456789abcdef12345678" // An access token
  },
  "email": {
    "address": "helpdesk@example.com", // The e-mail address of the help desk
    "waitTime": 10, // The amount of seconds to wait between each iteration
    "smtp": {
      "host": "smtp.example.com:465", // The address of the SMTP server
      "password": "1234", // The password for login (the username is the address)
      "ssl": true // Whether to enable ssl encryption
    },
    "pop3": {
      "host": "pop3.example.com:995", // The address of the POP3 server
      "password": "1234", // The password for login (the username is the address)
      "ssl": true // Whether to enable ssl encryption
    }
  },
  "database": {
    "connectionString": "postgresql://localhost/helpdesk?user=helpdesk" // The postgresql connection string (see postgresql jdbc documentation, sockets are supported)
  },
  "web": {
    "port": 80, // The port to host the website at
    "publicAddress": "http://127.0.0.1:80" // Where users will access the website
  }
}

It is also recommended to adjust the template files used in Gitea to reference the Helpdesk for users. The templates used on my own instance can be found in templates/