Merge pull request 'handbook_infrastructure' (#9) from handbook_infrastructure into modifications_2025-04-07

Reviewed-on: #9

docs/handbook/infrastructure/.nav.yml

@@ -1,5 +1,6 @@
 title: Infrastructure
 nav:
   - index.md
+  - apps
   - providers
   - naming_conventions.md

docs/handbook/infrastructure/apps/.nav.yml

@@ -0,0 +1,4 @@
+title: Apps
+nav:
+  - index.md
+  - monitoring

docs/handbook/infrastructure/apps/index.md

@@ -0,0 +1,11 @@
+# Apps
+
+!!! abstract "Placeholder Page"
+    This is a placeholder page. Please see the site navigation for any sub-pages that exist.
+
+---
+
+!!! example "Work in Progress"
+    This page is not complete, and is subject to change.
+
+    Want to help with this page? Please see [:octicons-arrow-right-24: Editing this site](https://about.starcat.systems/editing/) and the [:simple-forgejo: Git repo](https://git.starcat.systems/starcatsys/about_docs) for this site.

docs/handbook/infrastructure/apps/monitoring/.nav.yml

@@ -0,0 +1,5 @@
+title: Monitoring
+nav:
+  - index.md
+  - beszel.md
+  - uptime.md

docs/handbook/infrastructure/apps/monitoring/beszel.md

@@ -0,0 +1,14 @@
+# Beszel
+
+Simple, lightweight server monitoring
+
+**URL**: [:octicons-tab-external-16: beszel.starcatsys.net](https://beszel.starcatsys.net)  
+**Homepage**: [:octicons-link-external-24: beszel.dev](https://beszel.dev/)  
+**Hosting**: [:octicons-arrow-right-24: PikaPods](../../providers/servers_and_hosting/pikapods.md) `EU`
+
+---
+
+!!! example "Work in Progress"
+    This page is not complete, and is subject to change.
+
+    Want to help with this page? Please see [:octicons-arrow-right-24: Editing this site](https://about.starcat.systems/editing/) and the [:simple-forgejo: Git repo](https://git.starcat.systems/starcatsys/about_docs) for this site.

docs/handbook/infrastructure/apps/monitoring/index.md

@@ -0,0 +1,11 @@
+# Monitoring
+
+!!! abstract "Placeholder Page"
+    This is a placeholder page. Please see the site navigation for any sub-pages that exist.
+
+---
+
+!!! example "Work in Progress"
+    This page is not complete, and is subject to change.
+
+    Want to help with this page? Please see [:octicons-arrow-right-24: Editing this site](https://about.starcat.systems/editing/) and the [:simple-forgejo: Git repo](https://git.starcat.systems/starcatsys/about_docs) for this site.

docs/handbook/infrastructure/apps/monitoring/uptime.md

@@ -0,0 +1,16 @@
+# Uptime
+
+Uptime Kuma is an easy-to-use self-hosted monitoring tool.
+
+**URL**: [:octicons-tab-external-16: uptime.starcatsys.net](https://uptime.starcatsys.net)  
+**Homepage**: [:octicons-link-external-24: louislam/uptime-kuma - GitHub](https://github.com/louislam/uptime-kuma)  
+**Hosting**: [:octicons-arrow-right-24: PikaPods](../../providers/servers_and_hosting/pikapods.md) `EU`
+
+
+
+---
+
+!!! example "Work in Progress"
+    This page is not complete, and is subject to change.
+
+    Want to help with this page? Please see [:octicons-arrow-right-24: Editing this site](https://about.starcat.systems/editing/) and the [:simple-forgejo: Git repo](https://git.starcat.systems/starcatsys/about_docs) for this site.

docs/handbook/infrastructure/providers/communication/mxroute.md

@@ -2,9 +2,27 @@
 
 [:octicons-link-external-24: MXroute](https://mxroute.com/) hosts our email servers for coporate email, transactional messages, and Postline groups.
 
-## Connection Information
-Please see the [:octicons-lock-16: MXroute](https://git.starcat.systems/starcat-internal-docs/infra/wiki/MXroute) page of the internal wiki for connection and access information.
+## Servers
+List of MXroute servers that we use to run our infrastructure:  
+`heracles` - our current primary email server
 
+### `heracles`
+#### Quick Links
+[:octicons-link-external-24: Control panel](https://heracles.mxrouting.net:2222/) - limited access, contact admin if you need access or need to make changes  
+[:octicons-link-external-24: Basic webmail](https://heracles.mxrouting.net:2222/evo/roundcube) - log in with your full `@starcat.systems` or `@starcatsys.net` email address
+
+#### Connection Information
+IMAP Server: `heracles.mxrouting.net`  
+SMTP Server: `heracles.mxrouting.net`  
+
+PORTS:  
+IMAP SSL: `993`  
+IMAP Non-SSL: `143`  
+SMTP SSL: `465`  
+SMTP Non-SSL/STARTTLS: `25` or `587`  
+
+## Additional Information
+Please see the [:octicons-lock-16: MXroute](https://git.starcat.systems/starcat-internal-docs/infra/wiki/MXroute) for additional configuration and access information.
 ---
 !!! example "Work in Progress"
     This page is not complete, and is subject to change.

docs/handbook/infrastructure/providers/communication/voipms.md

@@ -1,6 +1,21 @@
 # Voip.ms
 [:octicons-link-external-24: Voip.ms](https://voip.ms/) provides phone numbers, calls, and text messages for corporate phone, and app communications.
 
+## Quick Links
+[:octicons-link-external-24: Control panel](https://voip.ms/signin/index.php?ln=en) - limited access, contact admin if you need access or need to make changes
+
+## Current Setup
+### Incoming Calls
+When someone calls our main number, the IVR tells them to visit our website for the most efficient support, or they can press ++5++ to leave a voicemail. They can also enter an extension to be forwarded out to a user's direct line, or press ++9++ to have the recording repeated.
+
+### Outgoing Calls
+If you need to make an outbound call from our main number, call the main number and press ++7++. Enter the outbound calls passcode (ask admin if you need the passcode), and then follow the prompts to place the call.
+
+### Voicemails
+By default, all voicemail messages are automatically emailed as an MP3 attachment and deleted from the system. The "Main VM" that incoming callers are directed to from the main menu is emailed to the `voipms_vm_main@starcatsys.net` email group.
+
+If you need to set or change your voicemail message for your direct line voicemail box, call in to the main number and enter your voicemail box number. (Or, you can enter your extension and wait for the ringing to stop.) When you reach your own voicemail recording, press the ++*++ (asterisk) key and log in with your voicemail PIN. (Forgot your voicemail box number or PIN? Ask an admin.)
+
 ---
 !!! example "Work in Progress"
     This page is not complete, and is subject to change.

docs/handbook/infrastructure/providers/network/bunny.md

@@ -1 +1,11 @@
-# Bunny
+# Bunny
+
+!!! abstract "Placeholder Page"
+    This is a placeholder page. Please see the site navigation for any sub-pages that exist.
+
+---
+
+!!! example "Work in Progress"
+    This page is not complete, and is subject to change.
+
+    Want to help with this page? Please see [:octicons-arrow-right-24: Editing this site](https://about.starcat.systems/editing/) and the [:simple-forgejo: Git repo](https://git.starcat.systems/starcatsys/about_docs) for this site.

docs/handbook/infrastructure/providers/servers_and_hosting/.nav.yml

@@ -2,4 +2,5 @@ title: Servers + Hosting
 nav:
   - index.md
   - hetzner.md
-  - nfsn.md
+  - nfsn.md
+  - pikapods.md

docs/handbook/infrastructure/providers/servers_and_hosting/nfsn.md

@@ -1 +1,11 @@
-# NFSN
+# NFSN
+
+!!! abstract "Placeholder Page"
+    This is a placeholder page. Please see the site navigation for any sub-pages that exist.
+
+---
+
+!!! example "Work in Progress"
+    This page is not complete, and is subject to change.
+
+    Want to help with this page? Please see [:octicons-arrow-right-24: Editing this site](https://about.starcat.systems/editing/) and the [:simple-forgejo: Git repo](https://git.starcat.systems/starcatsys/about_docs) for this site.

docs/handbook/infrastructure/providers/servers_and_hosting/pikapods.md

@@ -0,0 +1,18 @@
+# PikaPods
+[:octicons-link-external-24: PikaPods](https://pikapods.com/) is an open source app hosting provider that we use to host some of our internal apps.
+
+## Quick Links
+[:octicons-link-external-24: Control panel](https://www.pikapods.com/pods) - limited access, contact admin if you need access or need to make changes
+
+## Hosted Apps
+- [:octicons-arrow-right-24: Beszel](../../apps/monitoring/beszel.md)
+- [:octicons-arrow-right-24: Uptime](../../apps/monitoring/uptime.md)
+
+## Regions
+When it makes sense, host any new pods in the `EU` region, as it places the pod closer to the majority of our services. For our USA hosted services, or in other special situations, pods can also be hosted in the `US` region.
+
+---
+!!! example "Work in Progress"
+    This page is not complete, and is subject to change.
+
+    Want to help with this page? Please see [:octicons-arrow-right-24: Editing this site](../../../meta/editing.md) and the [:simple-forgejo: Git repo](https://git.starcat.systems/starcatsys/about_docs) for this site.