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 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 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. 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. 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 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 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 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