Federated Docs – MacOS

Docs: Connecting macOS

Tue, 30 May 2023 00:00:00 +0000

This is a placeholder page. Replace it with your own content.

Text can be bold, italic, or ~~strikethrough~~. Links should be blue with no underlines (unless hovered over).

There should be whitespace between paragraphs. Vape migas chillwave sriracha poutine try-hard distillery. Tattooed shabby chic small batch, pabst art party heirloom letterpress air plant pop-up. Sustainable chia skateboard art party banjo cardigan normcore affogato vexillologist quinoa meggings man bun master cleanse shoreditch readymade. Yuccie prism four dollar toast tbh cardigan iPhone, tumblr listicle live-edge VHS. Pug lyft normcore hot chicken biodiesel, actually keffiyeh thundercats photo booth pour-over twee fam food truck microdosing banh mi. Vice activated charcoal raclette unicorn live-edge post-ironic. Heirloom vexillologist coloring book, beard deep v letterpress echo park humblebrag tilde.

90’s four loko seitan photo booth gochujang freegan tumeric listicle fam ugh humblebrag. Bespoke leggings gastropub, biodiesel brunch pug fashion axe meh swag art party neutra deep v chia. Enamel pin fanny pack knausgaard tofu, artisan cronut hammock meditation occupy master cleanse chartreuse lumbersexual. Kombucha kogi viral truffaut synth distillery single-origin coffee ugh slow-carb marfa selfies. Pitchfork schlitz semiotics fanny pack, ugh artisan vegan vaporware hexagon. Polaroid fixie post-ironic venmo wolf ramps kale chips.

There should be no margin above this first sentence.

Blockquotes should be a lighter gray with a border along the left side in the secondary color.

There should be no margin below this final sentence.

First Header 2

This is a normal paragraph following a header. Knausgaard kale chips snackwave microdosing cronut copper mug swag synth bitters letterpress glossier craft beer. Mumblecore bushwick authentic gochujang vegan chambray meditation jean shorts irony. Viral farm-to-table kale chips, pork belly palo santo distillery activated charcoal aesthetic jianbing air plant woke lomo VHS organic. Tattooed locavore succulents heirloom, small batch sriracha echo park DIY af. Shaman you probably haven’t heard of them copper mug, crucifix green juice vape single-origin coffee brunch actually. Mustache etsy vexillologist raclette authentic fam. Tousled beard humblebrag asymmetrical. I love turkey, I love my job, I love my friends, I love Chardonnay!

Deae legum paulatimque terra, non vos mutata tacet: dic. Vocant docuique me plumas fila quin afuerunt copia haec o neque.

On big screens, paragraphs and headings should not take up the full container width, but we want tables, code blocks and similar to take the full width.

Scenester tumeric pickled, authentic crucifix post-ironic fam freegan VHS pork belly 8-bit yuccie PBR&B. I love this life we live in.

Second Header 2

This is a blockquote following a header. Bacon ipsum dolor sit amet t-bone doner shank drumstick, pork belly porchetta chuck sausage brisket ham hock rump pig. Chuck kielbasa leberkas, pork bresaola ham hock filet mignon cow shoulder short ribs biltong.

Header 3

This is a code block following a header.

Next level leggings before they sold out, PBR&B church-key shaman echo park. Kale chips occupy godard whatever pop-up freegan pork belly selfies. Gastropub Belinda subway tile woke post-ironic seitan. Shabby chic man bun semiotics vape, chia messenger bag plaid cardigan.

Header 4

This is an unordered list following a header.
This is an unordered list following a header.
This is an unordered list following a header.

Header 5

This is an ordered list following a header.
This is an ordered list following a header.
This is an ordered list following a header.

Header 6

What	Follows
A table	A header
A table	A header
A table	A header

There’s a horizontal rule above and below this.

Here is an unordered list:

Liverpool F.C.
Chelsea F.C.
Manchester United F.C.

And an ordered list:

Michael Brecker
Seamus Blake
Branford Marsalis

And an unordered task list:

Create a Hugo theme
Add task lists to it
Take a vacation

And a “mixed” task list:

Pack bags
?
Travel!

And a nested list:

Jackson 5
- Michael
- Tito
- Jackie
- Marlon
- Jermaine
TMNT
- Leonardo
- Michelangelo
- Donatello
- Raphael

Definition lists can be used with Markdown syntax. Definition headers are bold.

Name: Godzilla
Born: 1952
Birthplace: Japan
Color: Green

Tables should have bold headings and alternating shaded rows.

Artist	Album	Year
Michael Jackson	Thriller	1982
Prince	Purple Rain	1984
Beastie Boys	License to Ill	1986

If a table is too wide, it should scroll horizontally.

Artist	Album	Year	Label	Awards	Songs
Michael Jackson	Thriller	1982	Epic Records	Grammy Award for Album of the Year, American Music Award for Favorite Pop/Rock Album, American Music Award for Favorite Soul/R&B Album, Brit Award for Best Selling Album, Grammy Award for Best Engineered Album, Non-Classical	Wanna Be Startin' Somethin', Baby Be Mine, The Girl Is Mine, Thriller, Beat It, Billie Jean, Human Nature, P.Y.T. (Pretty Young Thing), The Lady in My Life
Prince	Purple Rain	1984	Warner Brothers Records	Grammy Award for Best Score Soundtrack for Visual Media, American Music Award for Favorite Pop/Rock Album, American Music Award for Favorite Soul/R&B Album, Brit Award for Best Soundtrack/Cast Recording, Grammy Award for Best Rock Performance by a Duo or Group with Vocal	Let’s Go Crazy, Take Me With U, The Beautiful Ones, Computer Blue, Darling Nikki, When Doves Cry, I Would Die 4 U, Baby I’m a Star, Purple Rain
Beastie Boys	License to Ill	1986	Mercury Records	noawardsbutthistablecelliswide	Rhymin & Stealin, The New Style, She’s Crafty, Posse in Effect, Slow Ride, Girls, (You Gotta) Fight for Your Right, No Sleep Till Brooklyn, Paul Revere, Hold It Now, Hit It, Brass Monkey, Slow and Low, Time to Get Ill

Code snippets like var foo = "bar"; can be shown inline.

Also, this should vertically align ~~with this~~ ~~and this~~.

Code can also be shown in a block element.

foo := "bar";
bar := "foo";

Code can also use syntax highlighting.

func main() {
  input := `var foo = "bar";`

  lexer := lexers.Get("javascript")
  iterator, _ := lexer.Tokenise(nil, input)
  style := styles.Get("github")
  formatter := html.New(html.WithLineNumbers())

  var buff bytes.Buffer
  formatter.Format(&buff, style, iterator)

  fmt.Println(buff.String())
}

Long, single-line code blocks should not wrap. They should horizontally scroll if they are too long. This line should be long enough to demonstrate this.

Inline code inside table cells should still be distinguishable.

Language	Code
Javascript	`var foo = "bar";`
Ruby	`foo = "bar"{`

Small images should be shown at their actual size.

Large images should always scale down and fit in the content container.

The photo above of the Spruce Picea abies shoot with foliage buds: Bjørn Erik Pedersen, CC-BY-SA.

Components

Alerts

This is an alert.

Note

This is an alert with a title.

Note

This is an alert with a title and Markdown.

This is a successful alert.

This is a warning.

Warning

This is a warning with a title.

Another Heading

Add some sections here to see how the ToC looks like. Bacon ipsum dolor sit amet t-bone doner shank drumstick, pork belly porchetta chuck sausage brisket ham hock rump pig. Chuck kielbasa leberkas, pork bresaola ham hock filet mignon cow shoulder short ribs biltong.

This Document

Inguina genus: Anaphen post: lingua violente voce suae meus aetate diversi. Orbis unam nec flammaeque status deam Silenum erat et a ferrea. Excitus rigidum ait: vestro et Herculis convicia: nitidae deseruit coniuge Proteaque adiciam eripitur? Sitim noceat signa probat quidem. Sua longis fugatis quidem genae.

Pixel Count

Tilde photo booth wayfarers cliche lomo intelligentsia man braid kombucha vaporware farm-to-table mixtape portland. PBR&B pickled cornhole ugh try-hard ethical subway tile. Fixie paleo intelligentsia pabst. Ennui waistcoat vinyl gochujang. Poutine salvia authentic affogato, chambray lumbersexual shabby chic.

Contact Info

Plaid hell of cred microdosing, succulents tilde pour-over. Offal shabby chic 3 wolf moon blue bottle raw denim normcore poutine pork belly.

External Links

Stumptown PBR&B keytar plaid street art, forage XOXO pitchfork selvage affogato green juice listicle pickled everyday carry hashtag. Organic sustainable letterpress sartorial scenester intelligentsia swag bushwick. Put a bird on it stumptown neutra locavore. IPhone typewriter messenger bag narwhal. Ennui cold-pressed seitan flannel keytar, single-origin coffee adaptogen occupy yuccie williamsburg chillwave shoreditch forage waistcoat.

This is the final element on the page and there should be no margin below this.

Docs: Element

Tue, 30 May 2023 00:00:00 +0000

This documentation is for users and administrators, not those wanting to install.

Your Federated Core comes pre-installed with a powerful Matrix server allowing you to communicate with anyone on your team and anyone in the world using Matrix.

The client for using Matrix is Element. You can use Element in a web broswer with your Federated Core, or you can install and use a desktop application.

Download desktop clients at this link. Note: in our experience, the “Debian / Ubuntu x86_64” instructions are the best way to get the Element desktop client rather than using your package manager.

When you launch the Element application the first time, you want to click “Sign In”. You will need to edit your “Homeserver” value and put in your “username” and “password”.

Userful information for configuring your Element desktop application.

Homeserver: https://matrix.domain.com where domain.com is your domain name.

Username: Your email address for your Federated Core.

Password: Your password.

You will need to verify your access using your security key OR from another device already logged in.

Docs: Nextcloud Applications

Tue, 30 May 2023 00:00:00 +0000

This documentation is for users and administrators, not those wanting to install.

Using this link you can find a variety of applications from Nextcloud allowing you to connect your desktop and mobile device to your Federated Core.

There are applications for “desktop” for MacOS, Windows, Linux. Note, if you’ve configure your Ubuntu-based Linux system using the built-in settings, you do not need a desktop client.

There are many applications offering integration with Nextcloud. You can find those listed at this link. Not all these applications work with your Federated Core, but many do. If we can be of assistance, please reach out for help.

Remember, your credentials for any application connecting with the Nextcloud installation on your Federated Core are:

Server: https://nextcloud.domain.com (where “domain.com” is your domain name)
User name: your Federated Core email address
Password: your Federated Core password

Docs: Notes

Tue, 30 May 2023 00:00:00 +0000

This documentation is for users and administrators, not those wanting to install.

Your Nextcloud installation includes the “Notes” application. You can choose to save your notes in either “.txt” (text) format or “.md” (markdown) format. You choose which format in “Notes”.

Whichever format you choose, if you have your Nextcloud desktop client installed and configured correctly, you can directly edit these notes using your desktop computer.

Choosing the “markdown” or “.md” format has the benefit of being able to style documents using simple text formatting commands. Here is a handy reference for “markdown”.

In fact, the website your are reading was created using Visual Source Code, Hugo, and publishing the files to the Gitea instance on a Federated Core. The is some magic (what is called a “webhook”) that looks for updates to the Gitea repository and publishes them to the web using Caddy. Amazing.

You can use many different desktop clients to work with and edit your Notes files.

Docs: Thunderbird

Tue, 30 May 2023 00:00:00 +0000

This documentation is for users and administrators, not those wanting to install.

Thunderbird isn’t clunky anymore. Lots of investment is going into this great email, calendar, contacts, and more desktop client.

You can download Thunderbird from their website.

The steps for configuring Thunderbird are practically the same for the major desktop platforms. Use the standard installation options and allow Thunderbird to be your default mail application.

You’ll be asked to enter your Federated Core email address. Thunderbird should auto-configure your settings, but if you need to manually set them up, here is the needed information:

IMAP

Server: mail.domain.com (where “domain.com” is your domain name. Example: mail.federated.com.) Port: 993 Security: SSL/TLS

SMTP

Server: mail.domain.com (where “domain.com” is your domain name. Example: mail.federated.com.) Port: 465 Security: SSL/TLS

Click “Finish” and you’re ready to send/receive email.

Contacts

In order to connect Thunderbird to the addresses kept in your Nextcloud application, select the small address book icon in the upper right of Thunderbird to select the “Address Book” mode.

Then select the drop down to the right and select “Add CardDAV Address Book”.

The put in your username (email) for your Federated Core into the “New CardDAV Address Book” dialog box.

You need to get the link for the “Location” line. This can be found in Nextcloud. Open a browser, enter the nextcloud.domain.com address for your Federated Core where “domain.com” is your particular domain name, navigate to the Contacts application, and then Contacts Settings in the lower left of the window. You’ll see a window like this:

You click on the three dots in the “Address books” section to see a drop down menu. Select “Copy link”. That is the link address we need for the “Location” in the prior dialog box in Thunderbird. You can switch back to Thunderbird and paste the link into the “Location” section of the dialog box then click “Continue”.

Now Thunderbird will ask you to authenticate to your Nextcloud application.

Enter your username (email address for Federated Core) and password. Click “OK” and you should have your Address Book from Nextcloud now connected to Thunderbird.

Calendars

These instructions work for any Calendar in your Nextcloud application. You can have Calendars for yourself/personal, decks, task lists, etc.

We will be adding a CalDAV calendar to Thunderbird. First switch to the Calendar mode in Thunderbird by clicking the calendar icon along the right side of the Thunderbird application.

You then click the “+” symbol so that we can add/subscribe to a calendar from Nextcloud.

We choose from the next dialog box to subscribe to a “On the Network” calendar and click “Next”.

Now we put in our username (email address).

In order to find the “Location” we need to switch to our Nextcloud application and navigate to the “Calendar” app.

You select the calendar you want to subscribe to by clicking on the “edit” function. Another dialogue box is presented:

Click on the “Copy private link” buttton to copy the desired “Location” to the clipboard. Now we can go back to Thunderbird and paste the link into the “Location” box and click “Find Calendars”.

When Thunderbird finds the calendar, it will ask us for our password for Nextcloud.

Enter your password and then click “OK”. Now we are asked to subscribe to the calendar.

Leave the “Calendar Type” as “CalDAV” and click “Subscribe”. Your calendar is now available in Thunderbird.

Docs: Wireguard

Tue, 30 May 2023 00:00:00 +0000

This documentation is for users and administrators, not those wanting to install.

(Note: will be finished when Wireguard/VPN is finished/fixed.)

Docs: Wireguard

Tue, 30 May 2023 00:00:00 +0000

This documentation is for users and administrators, not those wanting to install.

Note: you will need to ask your administrator for your configuration file to complete these steps. It should come as a file with the format of “name.conf”.

You will need to download the appropriate version of Wireguard for your system. You can find the installation links at this URL.

Configuration for Windows and MacOS

Once you have downloaded and installed Wireguard, start it up. You should see a window similar to the following.

Click the “+” (Macintosh) or “Add Tunnel” in the bottom left or the button “Import tunnel(s) from file”.

On the Macintosh, you may see the following warning:

Click “Allow”. Now you can click the “Activate” button to connect to your Federated Core VPN.

You are connected to your Federated Core and all internet traffic will be tunnelled through the Federated Core.

Configuration for Ubuntu-based Linux

Install Wireguard using the following command:

sudo apt install wireguard

Using the configuration file from your administrator, you can use the command line tools from Wireguard to connect to your Federated Core VPN.

Docs: Connecting macOS

Thu, 05 Jan 2017 00:00:00 +0000

This documentation is for users and administrators, not those wanting to install.

MacOS supports all the open protocols required to connect to your Nextcloud installation on Federated Core.

Internet Accounts

We configure access to common servers on macOS using the “Internet Accounts” option in “System Settings”.

You will want to choose the type of service you want to setup. We want to choose “Add Other Account…” This will give us access to options to set up email, calendar, and contacts.

Setting up email

Choose the option for “Mail account”.

You can put in your Federated Core email address and password, but the lookup witll fail.

You will need to put in the information for your Federated Core IMAP and SMTP server.

Here are the correct values:

Email address: your email address for your Federated Core account.
User Name: your email address for your Federated Core account.
Password: your password for your Federated Core account.
Incoming Mail Server: mail.domain.com (where “domain.com” is your domain name).
Outgoing Mail Server: mail.domain.com (where “domain.com” is your domain name).

Then you can sign in and choose which apps you want to use with your connected Federated Core account.

Now your Federated Core mail should show up in the Mail.app on your Macintosh computer.

Setting up calendar

You’ll go back to the section above for “Internet Accounts” and choose, this time, to set up a “CalDAV” account.

You put in the correct information for the calendar account in your Nextcloud installation.

You want to choose “Manual”. Here are the other values:

User Name: your email address for your Federated Core account.
Password: your password for your Federated Core account.
Server Address:

We get the server address from the Calendar application in Nextcloud. You click on the “pencil” icon and then get the following dialog…

Click on “Copy private link” and use that in the “Server Address” field above.

Now your Nextcloud calendar should show up in the Calendar.app on your Macintosh computer.

Setting up contacts

You’ll go back to the section above for “Internet Accounts” and choose, this time, to set up a “CardDAV” account.

You put in the correct information for the contacts account in your Nextcloud installation.

You want to choose “Manual”. Here are the other values:

User Name: your email address for your Federated Core account.
Password: your password for your Federated Core account.
Server Address:

We get the server address from the Contacts application in Nextcloud. You click on the “Contacts Settings” and then get the following dialog…

Click on “Copy link” next to “Contacts” and use that in the “Server Address” field above.

Now your Nextcloud contacts should show up in the Contacts.app on your Macintosh computer.

Docs: Office Suite

Tue, 30 May 2023 00:00:00 +0000

This documentation is for users and administrators, not those wanting to install.

The Nextcloud installation of your Federated Core works just like a product such as Dropbox(tm) or Google Drive(tm) and is compatible with office suites such as Microsoft Office(tm) or Libre Office(tm).

When you save a file from Microsoft Office(tm) or Libre Office(tm) to your “Files” on your Federated Core using your Nextcloud desktop client or the integration with Ubuntu-based Linux operating systems, that file is available for preview and work within the web interface of Nextcloud. This gives you maximum flexibility to work using desktop office tools or the web interface.

Let’s see how this might work. Note: you need to have the Nextcloud desktop client installed and configured, or your Ubuntu-based operating system configure to work with Nextcloud and the “Files” option turned on.

If you go to the “Files” application on Nextcloud in your browser at “nextcloud.domain.com” (where domaim.com is your domain name), you can click the big “+” (“plus”) symbol to get the following drop down.

In this example we will select and create a “New spreadsheet”. After giving our spreadsheet a name, Nextcloud opens a full-featured web editor for your spreadsheet. We’ve entered in some data. Changes are automatically saved.

Now, assuming the Nextcloud client is installed and configured, you can look in your file browser for your operating system and find the spreadsheet we created. Here’s what that looks like on Pop OS.

If you double click that, it will open in the office suite installed and configured to handle “xls*” files.

Here’s the same file synched to another machine running Windows.

And we can open the file and edit it in Excel…

Neat, huh? A couple of caveats. You can’t edit in Excel and expect to see the changes expressed in Libre Office on another machine. Excel and Libre Office don’t play nice together that way.

However, you can edit spreadsheets, documents, presentations and more on the web and then, using the share tools in Nextcloud “Files”, allow someone else to work on that file in the desktop editor of their choice.