From 611e28998a6135ab62dc748412045c438da3bcd1 Mon Sep 17 00:00:00 2001 From: thhsh-local Date: Fri, 11 Apr 2025 16:06:41 -0400 Subject: [PATCH 1/8] Mk infrastructure/apps with Uptime and Beszel --- docs/handbook/infrastructure/apps/.nav.yml | 4 ++++ docs/handbook/infrastructure/apps/index.md | 11 +++++++++++ .../infrastructure/apps/monitoring/.nav.yml | 5 +++++ .../infrastructure/apps/monitoring/beszel.md | 14 ++++++++++++++ .../infrastructure/apps/monitoring/index.md | 11 +++++++++++ .../infrastructure/apps/monitoring/uptime.md | 16 ++++++++++++++++ 6 files changed, 61 insertions(+) create mode 100644 docs/handbook/infrastructure/apps/.nav.yml create mode 100644 docs/handbook/infrastructure/apps/index.md create mode 100644 docs/handbook/infrastructure/apps/monitoring/.nav.yml create mode 100644 docs/handbook/infrastructure/apps/monitoring/beszel.md create mode 100644 docs/handbook/infrastructure/apps/monitoring/index.md create mode 100644 docs/handbook/infrastructure/apps/monitoring/uptime.md diff --git a/docs/handbook/infrastructure/apps/.nav.yml b/docs/handbook/infrastructure/apps/.nav.yml new file mode 100644 index 0000000..1e599be --- /dev/null +++ b/docs/handbook/infrastructure/apps/.nav.yml @@ -0,0 +1,4 @@ +title: Apps +nav: + - index.md + - monitoring \ No newline at end of file diff --git a/docs/handbook/infrastructure/apps/index.md b/docs/handbook/infrastructure/apps/index.md new file mode 100644 index 0000000..88f8079 --- /dev/null +++ b/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. \ No newline at end of file diff --git a/docs/handbook/infrastructure/apps/monitoring/.nav.yml b/docs/handbook/infrastructure/apps/monitoring/.nav.yml new file mode 100644 index 0000000..10c0e35 --- /dev/null +++ b/docs/handbook/infrastructure/apps/monitoring/.nav.yml @@ -0,0 +1,5 @@ +title: Monitoring +nav: + - index.md + - beszel.md + - uptime.md \ No newline at end of file diff --git a/docs/handbook/infrastructure/apps/monitoring/beszel.md b/docs/handbook/infrastructure/apps/monitoring/beszel.md new file mode 100644 index 0000000..76af88f --- /dev/null +++ b/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. \ No newline at end of file diff --git a/docs/handbook/infrastructure/apps/monitoring/index.md b/docs/handbook/infrastructure/apps/monitoring/index.md new file mode 100644 index 0000000..1a27594 --- /dev/null +++ b/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. \ No newline at end of file diff --git a/docs/handbook/infrastructure/apps/monitoring/uptime.md b/docs/handbook/infrastructure/apps/monitoring/uptime.md new file mode 100644 index 0000000..980d4e4 --- /dev/null +++ b/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. \ No newline at end of file From 68d70fd0ff80b29c56ef9e4eb47a229590cfc2e5 Mon Sep 17 00:00:00 2001 From: thhsh-local Date: Fri, 11 Apr 2025 16:06:53 -0400 Subject: [PATCH 2/8] Mk PikaPods --- .../providers/servers_and_hosting/pikapods.md | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) create mode 100644 docs/handbook/infrastructure/providers/servers_and_hosting/pikapods.md diff --git a/docs/handbook/infrastructure/providers/servers_and_hosting/pikapods.md b/docs/handbook/infrastructure/providers/servers_and_hosting/pikapods.md new file mode 100644 index 0000000..ce5b8e1 --- /dev/null +++ b/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. \ No newline at end of file From e4f055a0807d5175363ef4088648ae7737b00b3e Mon Sep 17 00:00:00 2001 From: thhsh-local Date: Fri, 11 Apr 2025 16:07:11 -0400 Subject: [PATCH 3/8] Upd MXroute connection info --- .../providers/communication/mxroute.md | 22 +++++++++++++++++-- 1 file changed, 20 insertions(+), 2 deletions(-) diff --git a/docs/handbook/infrastructure/providers/communication/mxroute.md b/docs/handbook/infrastructure/providers/communication/mxroute.md index e42ce67..3374f7e 100644 --- a/docs/handbook/infrastructure/providers/communication/mxroute.md +++ b/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. From d0c34fd361b8b0f4115c3137c40366b82479f4d4 Mon Sep 17 00:00:00 2001 From: thhsh-local Date: Fri, 11 Apr 2025 16:07:36 -0400 Subject: [PATCH 4/8] Upd voip.ms --- .../providers/communication/voipms.md | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/docs/handbook/infrastructure/providers/communication/voipms.md b/docs/handbook/infrastructure/providers/communication/voipms.md index d441377..800af69 100644 --- a/docs/handbook/infrastructure/providers/communication/voipms.md +++ b/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. From 3a4c38bdf66673e4c2f589a08468b1b29c95ec9f Mon Sep 17 00:00:00 2001 From: thhsh-local Date: Fri, 11 Apr 2025 16:07:49 -0400 Subject: [PATCH 5/8] Add placeholder for bunny --- .../infrastructure/providers/network/bunny.md | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) diff --git a/docs/handbook/infrastructure/providers/network/bunny.md b/docs/handbook/infrastructure/providers/network/bunny.md index e668c58..60d897d 100644 --- a/docs/handbook/infrastructure/providers/network/bunny.md +++ b/docs/handbook/infrastructure/providers/network/bunny.md @@ -1 +1,11 @@ -# Bunny \ No newline at end of file +# 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. \ No newline at end of file From aa1668b02a1f63d33b195f4bb12ef5e1f27805e7 Mon Sep 17 00:00:00 2001 From: thhsh-local Date: Fri, 11 Apr 2025 16:08:06 -0400 Subject: [PATCH 6/8] Add placeholder for NFSN --- .../providers/servers_and_hosting/nfsn.md | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) diff --git a/docs/handbook/infrastructure/providers/servers_and_hosting/nfsn.md b/docs/handbook/infrastructure/providers/servers_and_hosting/nfsn.md index eb43262..bc99308 100644 --- a/docs/handbook/infrastructure/providers/servers_and_hosting/nfsn.md +++ b/docs/handbook/infrastructure/providers/servers_and_hosting/nfsn.md @@ -1 +1,11 @@ -# NFSN \ No newline at end of file +# 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. \ No newline at end of file From 5f90c5d8e8948d480fc227972ad58eb6c2142706 Mon Sep 17 00:00:00 2001 From: thhsh-local Date: Fri, 11 Apr 2025 16:08:15 -0400 Subject: [PATCH 7/8] Mk PikaPods --- .../infrastructure/providers/servers_and_hosting/.nav.yml | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/handbook/infrastructure/providers/servers_and_hosting/.nav.yml b/docs/handbook/infrastructure/providers/servers_and_hosting/.nav.yml index fcc485a..4fd93eb 100644 --- a/docs/handbook/infrastructure/providers/servers_and_hosting/.nav.yml +++ b/docs/handbook/infrastructure/providers/servers_and_hosting/.nav.yml @@ -2,4 +2,5 @@ title: Servers + Hosting nav: - index.md - hetzner.md - - nfsn.md \ No newline at end of file + - nfsn.md + - pikapods.md \ No newline at end of file From 54bfcd919e542c8bbbef9e6ad125890597339014 Mon Sep 17 00:00:00 2001 From: thhsh-local Date: Fri, 11 Apr 2025 16:08:25 -0400 Subject: [PATCH 8/8] Add Apps to Infra --- docs/handbook/infrastructure/.nav.yml | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/handbook/infrastructure/.nav.yml b/docs/handbook/infrastructure/.nav.yml index 940cb1d..cfbf1f1 100644 --- a/docs/handbook/infrastructure/.nav.yml +++ b/docs/handbook/infrastructure/.nav.yml @@ -1,5 +1,6 @@ title: Infrastructure nav: - index.md + - apps - providers - naming_conventions.md \ No newline at end of file