documentation.federated.com.../content/en/docs/Getting started/welcome.md
2023-06-01 09:38:46 -06:00

7.6 KiB

title linkTitle date description
Welcome to Federated Core Welcome 2017-01-05 A short lead description about this content page. It can be **bold** or _italic_ and can be split over multiple paragraphs.

{{% pageinfo %}} This documentation is for users and administrators, not those wanting to install. {{% /pageinfo %}}

The following information is sent to each new Federated Core customer.

Dear Federated Customer,

Please read this note in its entirety since it has some important information for you to get the best use out of your Federated Core. If you ever get stuck for whatever reason, please reach out to us for support:

Phone: 415-779-5431

Email: support@federated.computer

We are here to help you, the Customer, get the most out of your Federated Core.

All documentation for your Federated Core can be found at https://documentation.federated.computer. There you'll find tips for how to use your Core and the various open source applications bundled with your Core.

Here are some quick pointers...

Note: Replace {domain.com} with the information you used when registering for the service.

Admin User

There is an "admin" or administrative use that has access to everything on your Federated Core. Here are the credentials for that user.

User name = "admin@{domain.com}", Password = "{password}"

You should log into "Panel" (see next section) and change the password.

Panel

Your control panel for users for most Federated Core apps and services is here: https://panel.{domain.com}. You will log in with the admin user and, then change the password (and ideally, save this password in a safe place for later reference).

You can also use Panel to create new user accounts for your team. You are able to give certain users administrative privileges, but please be cautious.

Email

Your email server has the following settings you can use to configure mobile and desktop email clients. Note: Nextcloud (next section) has a built-in web email client.

SMTP: Server is "mail.{domain.com}" and the port is "465". IMAP: Server is "mail.{domain.com}" and the port is "993".

The user and password for the email service is the full email address and password as assigned in Panel (see above). Example: rupert@federated.computer, 56tasty23.

Nextcloud: https://nextcloud.{domain.com}

The Nextcloud suite (replacing Google Workplace) provides apps and services covering mail, calendar, contacts, notes, tasks, files, word processing, spreadsheets, slides, project management (deck), bookmarks, forms, team talk, pictures, and an activity monitor. The user and password for the Nextcloud service is the full email address and password as assigned in Panel (see above). Example: rupert@federated.computer, 56tasty23.

There are a number of additional clients for mobile and desktop that work with Nextcloud. Please see https://documentation.federated.computer/core_applications/nextcloud for more information and other documentation.

Jitsi: https://jitsi.{domain.com}

Jitsi (your Zoom replacement) is a wonderful video conferencing solution. We have tuned Jitsi so that your Core can handle video conferences up to 8 people. NOTE, at this time the user and password for the Jitsi service is the user name ALONE and password as assigned in Panel (see above). Example: rupert, 56tasty23.

There are a number of mobile and desktop clients available to use with the Jitsi service. Please see https://documentation.federated.computer/core_applications/jitsi for more information and other documentation.

Element: https://element.{domain.com}

Element (a Slack replacement) provides you the ability to chat and communicate in real time with those on your team and outside of the team.

There are a number of mobile and desktop clients available to use with the Element service. Please see https://documentation.federated.computer/core_applications/element for more information and other documentation.

There are three services that do not use panel for user creation and management. This is for various reasons either based on the constraints for the current application, or so that you can share the system easily with users outside your team without giving access to other parts of your system.

Listmonk: https://listmonk.{domain.com}

Listmonk is a replacement for Mailchimp. You can set up and manage the email lists used to send out marketing messages. Listmonk is a single-user system and the user name is "listmonk@{domain.com}" and the password is {password}. For more information, please see the documentation https://documentation.federated.computer/core_applications/listmonk.

Baserow: https://baserow.{domain.com}

Baserow (an Airtable replacement) allows you to create customized databases without writing any code. It's an amazing product. The user authentication for Baserow is separate from Federated Core. To set up the service, log in as your "admin@{domain.com}" user with the correct password. You invite other users to Baserow within the service. For more information, please see the documentation https://documentation.federated.computer/core_applications/baserow.

Vaultwarden: https://vaultwarden.{domain.com}

Vaultwarden is a password manager. The user authentication for Vaultwarden is separate from Federated Core. To set up the service, log in as your "admin@{your_domain.com}" user with the correct password. You invite other users to Vaultwarden within the service itself. For more information, please see the documentation https://documentation.federated.computer/core_applications/vaultwarden.

Gitea: https://gitea.{domain.com}

Gitea is a code repository and management system similar to Github. The user authentication is seperate from Federated Core. To set up the service, log in as your "admin@{your_domain.com}" user with the correct password. You invite other users to Gitea within the service itself. For more information, please see the documentation https://documentation.federated.computer/core_applications/gitea.

VPN/Wireguard

Your core comes with a very powerful VPN solution built using Wireguard. The following information is needed by your users so that they can use the VPN. Please treat this information as a very important secret. There are two important parts of the VPN:

  1. VPN Interface

Address = {IP} PrivateKey = {privatekey} ListenPort = XXXXX DNS = {IP}

  1. VPN Peer

PublicKey = {publickey} PresharedKey = {presharedkey} Endpoint = vpn.{domain.com}:XXXXX AllowedIPs = XXX.XX.XX.XX/XX

Additional information about the VPN service can be found at https://documentation.federated.computer/core_applications/vpn.

PowerDNS: https://powerdns.{domain.com}

A very powerful tool for managing the DNS of your domain. Your Federated Core has a number of sub-domains pre-configured (examples: mail.domain.com, jitsi.domain.com, etc.) But if you need another sub-domain to connect your domain to a service outside your Federated Core, use PowerDNS.

Additional information about the PowerDNS service can be found at https://documentation.federated.computer/docs/core_applications/powerdns.

Traefik: https://traefik.{domain.com}

Another super-user tool. Traefik is a powerful "application proxy".

Additional information about the VPN service can be found at https://documentation.federated.computer/docs/core_applications/traefik.

Thanks and Additional Support

Thank you for your support of Federated. We really appreciate it and hope you have a very successful time with Federated Core.

Again, if we can be of any assistance, please don't hesitate to get in touch. Don't hesitate.

It's your computer. Let's make it work for you!