diff --git a/src/SUMMARY.md b/src/SUMMARY.md index e90ab817d..12b850a1b 100644 --- a/src/SUMMARY.md +++ b/src/SUMMARY.md @@ -283,6 +283,7 @@ Server Hosting - [Setting up SS14.Watchdog](en/server-hosting/setting-up-ss14-watchdog.md) - [OAuth](en/server-hosting/oauth.md) - [Setting up Discord Integration](en/server-hosting/setting-up-discord-integration.md) +- [Setting up Github Integration](en/server-hosting/setting-up-github-integration.md) - [Maintenance]() - [Debugging server lockups](en/server-hosting/maintenance/debugging-server-lockups.md) diff --git a/src/en/assets/images/github/app_id.png b/src/en/assets/images/github/app_id.png new file mode 100644 index 000000000..2521daa96 Binary files /dev/null and b/src/en/assets/images/github/app_id.png differ diff --git a/src/en/assets/images/github/install.png b/src/en/assets/images/github/install.png new file mode 100644 index 000000000..28a9c4227 Binary files /dev/null and b/src/en/assets/images/github/install.png differ diff --git a/src/en/assets/images/github/install_location.png b/src/en/assets/images/github/install_location.png new file mode 100644 index 000000000..1fac62776 Binary files /dev/null and b/src/en/assets/images/github/install_location.png differ diff --git a/src/en/assets/images/github/only_select_repos.png b/src/en/assets/images/github/only_select_repos.png new file mode 100644 index 000000000..f432c568b Binary files /dev/null and b/src/en/assets/images/github/only_select_repos.png differ diff --git a/src/en/assets/images/github/permissions.png b/src/en/assets/images/github/permissions.png new file mode 100644 index 000000000..ffcb39450 Binary files /dev/null and b/src/en/assets/images/github/permissions.png differ diff --git a/src/en/assets/images/github/private_key.png b/src/en/assets/images/github/private_key.png new file mode 100644 index 000000000..fd6e35f63 Binary files /dev/null and b/src/en/assets/images/github/private_key.png differ diff --git a/src/en/server-hosting/setting-up-github-integration.md b/src/en/server-hosting/setting-up-github-integration.md new file mode 100644 index 000000000..9bc231415 --- /dev/null +++ b/src/en/server-hosting/setting-up-github-integration.md @@ -0,0 +1,37 @@ +# Setting up GitHub integration +SS14 servers support basic github integration. Currently this is just creation of bug reports! + +# Setup +Setting this up will allow any player who meets the requirements (See [Important CVars](#important-cvars)) to make bug reports. + +0. (Optional) Create a new repository that only your GitHub organization has access to. You can transfer issues from this new repository to your main repository. You might want to do this if you are worried about spanning the main repository. +1. Create a new app (`https://github.com/settings/apps`). When creating the app, only allow issue creation permissions (and metadata). **Make sure you are logged in as the repository owner** (This is usually the organization itself)! You do not need a webhook URL. +![SS14 Status](../assets/images/github/permissions.png) +![SS14 Status](../assets/images/github/install.png) +2. Under the "General" tab, get the apps app ID and also generate a private key. This will download the private key to your computer. +![SS14 Status](../assets/images/github/app_id.png) +![SS14 Status](../assets/images/github/private_key.png) +3. Install the app in your orginzation, and only give it access to one repository. +![SS14 Status](../assets/images/github/install_location.png) +![SS14 Status](../assets/images/github/only_select_repos.png) +4. Add this to your server configuration +```toml +[github] +# Can be found at https://github.com/settings/apps/APPNAME - scroll to the bottom +github_app_private_key_path = "/home/root/appName.2025-08-15.private-key.pem" +# The app id found at https://github.com/settings/apps/APPNAME +github_app_id = 1787332 +# If url is: https://github.com/space-wizards/space-station-14 +# repo name is "space-station-14", repo owner is "space-wizards" +github_repository_name = "space-station-14" +github_repository_owner = "space-wizards" + +[bug_reports] +enable_player_bug_reports = true +``` + +# Testing +If you run into issues, the servers console should display errors, make sure to look at that if issues are not being created. The `testgithubapi` also will do a few checks to ensure you filled out all the required fields (And also create 1 issue). + +# CVars +Go to `CCVars.BugReports.cs` for the full updated list of cvars! Almost all the settings can be tweaked there - you probably want to change them depending on what type of fork you are running. Put them in the server configuration to change them like the other settings. \ No newline at end of file