839 lines
41 KiB
XML
839 lines
41 KiB
XML
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
|
||
<channel>
|
||
<title>Federated Docs – Core Applications</title>
|
||
<link>/docs/core_applications/</link>
|
||
<description>Recent content in Core Applications on Federated Docs</description>
|
||
<generator>Hugo -- gohugo.io</generator>
|
||
<lastBuildDate>Tue, 30 May 2023 00:00:00 +0000</lastBuildDate>
|
||
|
||
<atom:link href="/docs/core_applications/index.xml" rel="self" type="application/rss+xml" />
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
<item>
|
||
<title>Docs: Baserow</title>
|
||
<link>/docs/core_applications/baserow/</link>
|
||
<pubDate>Tue, 30 May 2023 00:00:00 +0000</pubDate>
|
||
|
||
<guid>/docs/core_applications/baserow/</guid>
|
||
<description>
|
||
|
||
|
||
|
||
|
||
<div class="pageinfo pageinfo-primary">
|
||
<p>This documentation is for users and administrators, not those wanting to install.</p>
|
||
|
||
</div>
|
||
|
||
<p>Access to Baserow is at: <a href="https://baserow.domain.com">https://baserow.domain.com</a> where &ldquo;domain.com&rdquo; is your domain name.</p>
|
||
<p><strong>Configuring Users for Baserow</strong></p>
|
||
<p>The users for Baserow are <em>not</em> integrated with your Federated Core user management system. You will need to create users and permissions for those users wanting to use Baserow. In this way, you can give users outside your domain access to Baserow applications without giving them access and permissions to your other sensitive data on your Federated Core.</p>
|
||
<p>Using your administrative user account, log into Baserow.</p>
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
<figure class="card rounded p-2 td-post-card mb-4 mt-4" style="max-width: 603px">
|
||
<img class="card-img-top" src="/docs/core_applications/baserow/login_hu9486f649700587857f8c3a498cb9aed1_15669_593x491_resize_catmullrom_3.png" width="593" height="491">
|
||
|
||
<figcaption class="card-body px-0 pt-2 pb-0">
|
||
<p class="card-text">
|
||
</p>
|
||
</figcaption>
|
||
|
||
</figure>
|
||
|
||
<p>Once logged in, you can invite other team members to your installation.</p>
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
<figure class="card rounded p-2 td-post-card mb-4 mt-4" style="max-width: 657px">
|
||
<img class="card-img-top" src="/docs/core_applications/baserow/invite_hu4ef6d6c85ad5d02ebc14dbaf0cfc4753_14154_647x294_resize_catmullrom_3.png" width="647" height="294">
|
||
|
||
<figcaption class="card-body px-0 pt-2 pb-0">
|
||
<p class="card-text">
|
||
</p>
|
||
</figcaption>
|
||
|
||
</figure>
|
||
|
||
<blockquote>
|
||
<p>Tip: You may want to use the email address as the username format for consistency sake with the rest of the Federated Core.</p>
|
||
</blockquote>
|
||
<p><strong>Official Baserow User Documentation</strong></p>
|
||
<p>For additional information about using Baserow, please consult the <a href="https://baserow.io/user-docs">user documentation</a>.</p>
|
||
|
||
</description>
|
||
</item>
|
||
|
||
<item>
|
||
<title>Docs: Listmonk</title>
|
||
<link>/docs/core_applications/listmonk/</link>
|
||
<pubDate>Tue, 30 May 2023 00:00:00 +0000</pubDate>
|
||
|
||
<guid>/docs/core_applications/listmonk/</guid>
|
||
<description>
|
||
|
||
|
||
|
||
|
||
<div class="pageinfo pageinfo-primary">
|
||
<p>This documentation is for users and administrators, not those wanting to install.</p>
|
||
|
||
</div>
|
||
|
||
<p>Access to Listmonk is at: <a href="https://listmonk.domain.com">https://listmonk.domain.com</a> where &ldquo;domain.com&rdquo; is your domain name.</p>
|
||
<p><strong>Setting Up Listmonk</strong></p>
|
||
<p>Listmonk is a <em>single user</em> system. It is light-weight, very efficient, does most of what you want in an email list management system, but it is <em>not</em> multiuser.</p>
|
||
<p>In order to access Listmonk, there is a special user set up for your Federated Core.</p>
|
||
<ul>
|
||
<li>Username: listmonk</li>
|
||
<li>Password: given to you when your Federated Core was set up</li>
|
||
</ul>
|
||
<p>Access Listmonk, and click the &ldquo;Login&rdquo; button:</p>
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
<figure class="card rounded p-2 td-post-card mb-4 mt-4" style="max-width: 597px">
|
||
<img class="card-img-top" src="/docs/core_applications/listmonk/login_huc6a82a82b159b05f3f0b3bee9aaffaf8_9733_587x319_resize_catmullrom_3.png" width="587" height="319">
|
||
|
||
<figcaption class="card-body px-0 pt-2 pb-0">
|
||
<p class="card-text">
|
||
</p>
|
||
</figcaption>
|
||
|
||
</figure>
|
||
|
||
<p>Then enter in your credentials:</p>
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
<figure class="card rounded p-2 td-post-card mb-4 mt-4" style="max-width: 376px">
|
||
<img class="card-img-top" src="/docs/core_applications/listmonk/signin_hue4b6f42c34c8a8930c052ac90e0ba234_12247_366x267_resize_catmullrom_3.png" width="366" height="267">
|
||
|
||
<figcaption class="card-body px-0 pt-2 pb-0">
|
||
<p class="card-text">
|
||
</p>
|
||
</figcaption>
|
||
|
||
</figure>
|
||
|
||
<p>There are a few items we will have to configure to use Listmonk.</p>
|
||
<p>The rest will be finished when Federated Core is done.</p>
|
||
|
||
</description>
|
||
</item>
|
||
|
||
<item>
|
||
<title>Docs: Panel</title>
|
||
<link>/docs/core_applications/panel/</link>
|
||
<pubDate>Tue, 30 May 2023 00:00:00 +0000</pubDate>
|
||
|
||
<guid>/docs/core_applications/panel/</guid>
|
||
<description>
|
||
|
||
|
||
|
||
|
||
<div class="pageinfo pageinfo-primary">
|
||
<p>This documentation is for users and administrators, not those wanting to install.</p>
|
||
|
||
</div>
|
||
|
||
<p>Access to Panel is at: <a href="https://panel.domain.com">https://panel.domain.com</a> where &ldquo;domain.com&rdquo; is your domain name.</p>
|
||
<p>Panel is where you manage users and user permissions for your Federated Core.</p>
|
||
<blockquote>
|
||
<p>Note: this information is only relevant to the administrative user and those given administrative rights. For information on how a user can change their password, please read <a href="">this document</a>.</p>
|
||
</blockquote>
|
||
<p><strong>Log In</strong></p>
|
||
<p>Click the &ldquo;Log In&rdquo; at the top of the screen.</p>
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
<figure class="card rounded p-2 td-post-card mb-4 mt-4" style="max-width: 325px">
|
||
<img class="card-img-top" src="/docs/core_applications/panel/menu_huce869143c216f83f2fc102a08defabf8_3334_315x64_resize_catmullrom_3.png" width="315" height="64">
|
||
|
||
<figcaption class="card-body px-0 pt-2 pb-0">
|
||
<p class="card-text">
|
||
</p>
|
||
</figcaption>
|
||
|
||
</figure>
|
||
|
||
<p>Log into Panel using &ldquo;admin&rdquo; and the password for your administrative user. You can find the password in the &ldquo;Welcome&rdquo; information sent to your when your Federated Core was created AND you haven&rsquo;t changed your password.</p>
|
||
<blockquote>
|
||
<p>Note: if you can&rsquo;t log into Panel, please reach out to us for help. While we don&rsquo;t know your password, we can reset it so that you can get access.</p>
|
||
</blockquote>
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
<figure class="card rounded p-2 td-post-card mb-4 mt-4" style="max-width: 763px">
|
||
<img class="card-img-top" src="/docs/core_applications/panel/login_hu8ea1b940a085d3697efc685c7636766b_7233_753x242_resize_catmullrom_3.png" width="753" height="242">
|
||
|
||
<figcaption class="card-body px-0 pt-2 pb-0">
|
||
<p class="card-text">
|
||
</p>
|
||
</figcaption>
|
||
|
||
</figure>
|
||
|
||
<p>Once logged into Panel, you can create a user:</p>
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
<figure class="card rounded p-2 td-post-card mb-4 mt-4" style="max-width: 764px">
|
||
<img class="card-img-top" src="/docs/core_applications/panel/newuser_hu7447b458642072d2dc7fd22230a13654_29789_754x633_resize_catmullrom_3.png" width="754" height="633">
|
||
|
||
<figcaption class="card-body px-0 pt-2 pb-0">
|
||
<p class="card-text">
|
||
</p>
|
||
</figcaption>
|
||
|
||
</figure>
|
||
|
||
<p>A few comments on this dialog box.</p>
|
||
<ul>
|
||
<li>The &ldquo;system name&rdquo; is the part of the email address given to the user <em>before</em> the &ldquo;@&rdquo; symbol.</li>
|
||
<li>The password you give must be &ldquo;strong&rdquo; so there is a helpful &ldquo;Generate password&rdquo; feature. It is suggested you use this and then have the user change password.</li>
|
||
<li>The &ldquo;Email these credentials to the user?&rdquo; feature sends and email to the newly created Federated Core email address. Not very useful, we know. The user will have it as a reference. But, you should copy the password and send it to the new user using some method <em>outside</em> of your Federated Core.</li>
|
||
</ul>
|
||
<p>It is possible to make some of your users administrators.</p>
|
||
<blockquote>
|
||
<p>Warning: be careful with this functionality because an administrator is able to do significant damage to your Federated Core, delete other user accounts, get access to sensitive date, etc.</p>
|
||
</blockquote>
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
<figure class="card rounded p-2 td-post-card mb-4 mt-4" style="max-width: 1139px">
|
||
<img class="card-img-top" src="/docs/core_applications/panel/groups_hucac20460262638687bec124b54848e10_33886_1129x573_resize_catmullrom_3.png" width="1129" height="573">
|
||
|
||
<figcaption class="card-body px-0 pt-2 pb-0">
|
||
<p class="card-text">
|
||
</p>
|
||
</figcaption>
|
||
|
||
</figure>
|
||
|
||
<p>Move the users to want to be administrators into/out of the &ldquo;admin&rdquo; group using the &ldquo;&lt;&rdquo; and &ldquo;&gt;&rdquo; buttons.</p>
|
||
<blockquote>
|
||
<p>Warning: you can but you do not <em>want</em> to delete the &ldquo;admin&rdquo; group. That will make everyone very sad and you&rsquo;ll need to reach out to Federated support to bring joy back into your life.</p>
|
||
</blockquote>
|
||
<p><strong>User Password Change</strong></p>
|
||
<p>If a user on your system wants to change password, have the user log into Panel with their system user (the part of the user&rsquo;s email address before the &ldquo;@&rdquo; symbol).</p>
|
||
<p>Since the user is <em>not</em> an administrative user, they will be presented with a utility for changing password.</p>
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
<figure class="card rounded p-2 td-post-card mb-4 mt-4" style="max-width: 581px">
|
||
<img class="card-img-top" src="/docs/core_applications/panel/pass_hu938bc64d7600c8a1c7c31c58d6cc3df8_31772_571x384_resize_catmullrom_3.png" width="571" height="384">
|
||
|
||
<figcaption class="card-body px-0 pt-2 pb-0">
|
||
<p class="card-text">
|
||
</p>
|
||
</figcaption>
|
||
|
||
</figure>
|
||
|
||
<p>The utility checks to ensure your password is sufficiently strong. Sorry, we don&rsquo;t want you to get hacked.</p>
|
||
<p><strong>Need Support?</strong></p>
|
||
<p>Need some support? Don&rsquo;t hesitate to reach out to Federated customer support:</p>
|
||
<ul>
|
||
<li><a href="https://support.federated.computer">https://support.federated.computer</a></li>
|
||
<li>email: <a href="mailto:support@federated.computer">support@federated.computer</a></li>
|
||
<li>phone: 415-779-3333</li>
|
||
</ul>
|
||
|
||
</description>
|
||
</item>
|
||
|
||
<item>
|
||
<title>Docs: PowerDNS</title>
|
||
<link>/docs/core_applications/powerdns/</link>
|
||
<pubDate>Tue, 30 May 2023 00:00:00 +0000</pubDate>
|
||
|
||
<guid>/docs/core_applications/powerdns/</guid>
|
||
<description>
|
||
|
||
|
||
|
||
|
||
<div class="pageinfo pageinfo-primary">
|
||
<p>This documentation is for users and administrators, not those wanting to install.</p>
|
||
|
||
</div>
|
||
|
||
<p>Access to PowerDNS is at: <a href="https://powerdns.domain.com">https://powerdns.domain.com</a> where &ldquo;domain.com&rdquo; is your domain name.</p>
|
||
<blockquote>
|
||
<p>Note: this service is restricted to the administrative user for your Federated Core.</p>
|
||
</blockquote>
|
||
<p>Username: admin
|
||
Password: password for the admin user.</p>
|
||
<p>Click on you domain and then add an &ldquo;A&rdquo; record to add additional sub-domains.</p>
|
||
<p>PowerDNS <a href="https://github.com/PowerDNS-Admin/PowerDNS-Admin/blob/master/.github/SUPPORT.md">Support Guide</a>.</p>
|
||
|
||
</description>
|
||
</item>
|
||
|
||
<item>
|
||
<title>Docs: Vaultwarden</title>
|
||
<link>/docs/core_applications/vaultwarden/</link>
|
||
<pubDate>Tue, 30 May 2023 00:00:00 +0000</pubDate>
|
||
|
||
<guid>/docs/core_applications/vaultwarden/</guid>
|
||
<description>
|
||
|
||
|
||
|
||
|
||
<div class="pageinfo pageinfo-primary">
|
||
<p>This documentation is for users and administrators, not those wanting to install.</p>
|
||
|
||
</div>
|
||
|
||
<p>Access to Vaultwarden is at: <a href="https://vaultwarden.domain.com">https://vaultwarden.domain.com</a> where &ldquo;domain.com&rdquo; is your domain name.</p>
|
||
<p><strong>Setting Up Users</strong></p>
|
||
<p>In a future version of</p>
|
||
<p>Waiting for changes to Federated Core to finish documentation&hellip;</p>
|
||
|
||
</description>
|
||
</item>
|
||
|
||
<item>
|
||
<title>Docs: Wireguard</title>
|
||
<link>/docs/core_applications/wireguard/</link>
|
||
<pubDate>Tue, 30 May 2023 00:00:00 +0000</pubDate>
|
||
|
||
<guid>/docs/core_applications/wireguard/</guid>
|
||
<description>
|
||
|
||
|
||
|
||
|
||
<div class="pageinfo pageinfo-primary">
|
||
<p>This documentation is for users and administrators, not those wanting to install.</p>
|
||
|
||
</div>
|
||
|
||
<p>Access to Wireguard is entirely through the Wireguard application on your desktop computer or mobile device.</p>
|
||
<p>Please look at the Wireguard section of Client Applications of the documentation for information on different types of supported devices.</p>
|
||
<p>You will need to have the &ldquo;tunnel&rdquo; information for your Wireguard service. It is provided to you when your Federated Core is installed.</p>
|
||
<blockquote>
|
||
<p>Note for administrators: you can save the Wireguard tunnel information in a file and distribute that to your users.</p>
|
||
</blockquote>
|
||
<blockquote>
|
||
<p>Note: please save the file as a &ldquo;.conf&rdquo; file so that it is recognized by the Wireguard client software.</p>
|
||
</blockquote>
|
||
<blockquote>
|
||
<p>Suggestion: use the format &ldquo;wg0.conf&rdquo; for your Wireguard file. You can then email this file to all your users.</p>
|
||
</blockquote>
|
||
|
||
</description>
|
||
</item>
|
||
|
||
<item>
|
||
<title>Docs: Element</title>
|
||
<link>/docs/core_applications/element/</link>
|
||
<pubDate>Thu, 05 Jan 2017 00:00:00 +0000</pubDate>
|
||
|
||
<guid>/docs/core_applications/element/</guid>
|
||
<description>
|
||
|
||
|
||
|
||
|
||
<div class="pageinfo pageinfo-primary">
|
||
<p>This documentation is for users and administrators, not those wanting to install.</p>
|
||
|
||
</div>
|
||
|
||
<p>Access to Element is at: <a href="https://element.domain.com">https://element.domain.com</a> where &ldquo;domain.com&rdquo; is your domain name.</p>
|
||
<p><strong>Logging into Element</strong></p>
|
||
<p>Your Element credentials are as follows:</p>
|
||
<ul>
|
||
<li>Homeserver: <a href="https://matrix.domain.com">https://matrix.domain.com</a> where &ldquo;domain.com&rdquo; is your domain name.</li>
|
||
<li>Username: your email address for your Federated Core</li>
|
||
<li>Password: your password for your Federated Core</li>
|
||
</ul>
|
||
<p>You will see a login page the first time you connect to Element.</p>
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
<figure class="card rounded p-2 td-post-card mb-4 mt-4" style="max-width: 540px">
|
||
<img class="card-img-top" src="/docs/core_applications/element/login_hudab7af5854b6b7e1980696eb67157272_130741_530x360_resize_catmullrom_3.png" width="530" height="360">
|
||
|
||
<figcaption class="card-body px-0 pt-2 pb-0">
|
||
<p class="card-text">
|
||
</p>
|
||
</figcaption>
|
||
|
||
</figure>
|
||
|
||
<p>Even though there is an option for &ldquo;Create Account&rdquo;, new accounts are turned off so that random folks from the internet can&rsquo;t get onto your server. Accounts for Federated Core are created in &ldquo;Panel&rdquo; (with the exception of Listmonk, Vaultwarden, Baserow, Gitea).</p>
|
||
<p>Click the &ldquo;Sign In&rdquo; buttton.</p>
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
<figure class="card rounded p-2 td-post-card mb-4 mt-4" style="max-width: 767px">
|
||
<img class="card-img-top" src="/docs/core_applications/element/edit_hu36eb8934bcf3e36b5b0df952571c6926_175429_757x510_resize_catmullrom_3.png" width="757" height="510">
|
||
|
||
<figcaption class="card-body px-0 pt-2 pb-0">
|
||
<p class="card-text">
|
||
</p>
|
||
</figcaption>
|
||
|
||
</figure>
|
||
|
||
<p>Your Matrix server should be automatically filled in for the &ldquo;Homeserver&rdquo;.</p>
|
||
<p>Sign in using:</p>
|
||
<ul>
|
||
<li>Username: your Federated Core email address.</li>
|
||
<li>Password: your Federated Core password.</li>
|
||
</ul>
|
||
<blockquote>
|
||
<p>Note: the &ldquo;Forget password&rdquo; functionality doesn&rsquo;t work since user accounts are managed outside Element and Matrix.</p>
|
||
</blockquote>
|
||
<p>Click the &ldquo;Sign in&rdquo; button.</p>
|
||
<p>You&rsquo;re in Element using your own personal Matrix server. You can &ldquo;federate&rdquo; with the 100s of thousands of other Matrix servers around the globe. Check out the official user documentation below.</p>
|
||
<p><strong>Important Note About Keys</strong></p>
|
||
<p>Element and Matrix are end-to-end encrypted so that no one can snoop on your communications. However, this functionality comes with some responsibility. You need to backup your keys so that you can have access to your conversations when you decide to use the desktop or mobile Element application to connect with your Matrix server, log out and want to log back in, etc.</p>
|
||
<p>Let&rsquo;s walk through the process of backing up your keys.</p>
|
||
<p>Using the small circle that represents your account, click the circle and choose the option for &ldquo;All settings&rdquo;.</p>
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
<figure class="card rounded p-2 td-post-card mb-4 mt-4" style="max-width: 331px">
|
||
<img class="card-img-top" src="/docs/core_applications/element/dropdown_huafa200581f37de46d40fcf43f2f08c1a_21743_321x346_resize_catmullrom_3.png" width="321" height="346">
|
||
|
||
<figcaption class="card-body px-0 pt-2 pb-0">
|
||
<p class="card-text">
|
||
</p>
|
||
</figcaption>
|
||
|
||
</figure>
|
||
|
||
<p>Once in &ldquo;All settings&rdquo;, choose the option for &ldquo;Security &amp; Privacy&rdquo;.</p>
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
<figure class="card rounded p-2 td-post-card mb-4 mt-4" style="max-width: 548px">
|
||
<img class="card-img-top" src="/docs/core_applications/element/securebackup_hu2a147f1e401efb5f69f8c00c0e450a54_16377_538x117_resize_catmullrom_3.png" width="538" height="117">
|
||
|
||
<figcaption class="card-body px-0 pt-2 pb-0">
|
||
<p class="card-text">
|
||
</p>
|
||
</figcaption>
|
||
|
||
</figure>
|
||
|
||
<p>You want to select the option for &ldquo;Set up Secure Backup&rdquo;. This will bring you to the &ldquo;Set up Secure Backup&rdquo; dialog.</p>
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
<figure class="card rounded p-2 td-post-card mb-4 mt-4" style="max-width: 609px">
|
||
<img class="card-img-top" src="/docs/core_applications/element/setup_hu0e21bc83234718f204246db055e36e8c_50733_599x453_resize_catmullrom_3.png" width="599" height="453">
|
||
|
||
<figcaption class="card-body px-0 pt-2 pb-0">
|
||
<p class="card-text">
|
||
</p>
|
||
</figcaption>
|
||
|
||
</figure>
|
||
|
||
<p>We recommend using the &ldquo;Generate a Security Key&rdquo; option. Click &ldquo;Continue&rdquo;. You will be shown your key and asked how you want to save it.</p>
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
<figure class="card rounded p-2 td-post-card mb-4 mt-4" style="max-width: 606px">
|
||
<img class="card-img-top" src="/docs/core_applications/element/keys_hua113a171fcf65b91dbbaa285aabd9259_31035_596x368_resize_catmullrom_3.png" width="596" height="368">
|
||
|
||
<figcaption class="card-body px-0 pt-2 pb-0">
|
||
<p class="card-text">
|
||
</p>
|
||
</figcaption>
|
||
|
||
</figure>
|
||
|
||
<p>It is VERY important that you save this key in a secure place. You can use your Federated Core installation of Vaultwarden to save the key. This key is used when logging into the Element/Matrix service on your Federated Core elsewhere and you want to verify your identity.</p>
|
||
<p><strong>Official Element User Documentation</strong></p>
|
||
<p>For additional information about using Element, please consult the <a href="https://element.io/user-guide">user documentation</a>. Some of this documentation may not be relevant to your own installation of Element/Matrix based on how users are managed on your Federated Core.</p>
|
||
|
||
</description>
|
||
</item>
|
||
|
||
<item>
|
||
<title>Docs: Gitea</title>
|
||
<link>/docs/core_applications/gitea/</link>
|
||
<pubDate>Thu, 05 Jan 2017 00:00:00 +0000</pubDate>
|
||
|
||
<guid>/docs/core_applications/gitea/</guid>
|
||
<description>
|
||
|
||
|
||
|
||
|
||
<div class="pageinfo pageinfo-primary">
|
||
<p>This documentation is for users and administrators, not those wanting to install.</p>
|
||
|
||
</div>
|
||
|
||
<p>Access to Gitea is at: <a href="https://gitea.domain.com">https://gitea.domain.com</a> where &ldquo;domain.com&rdquo; is your domain name.</p>
|
||
<p>The Gitea service on your Federated Core allows you to manage code repositories just like a service such as Github, but also publish a website, documentation, and a blog.</p>
|
||
<p><strong>Setting Up Gitea Users</strong></p>
|
||
<p>So that you can share your code repositories with users outside your domain, the Gitea installation on your Federated Core does <em>not</em> use Panel for user creation and management.</p>
|
||
<p>To set up Gitea, you log in with the following credentials:</p>
|
||
<ul>
|
||
<li>Username: gitea</li>
|
||
<li>Password: password for you admin user</li>
|
||
</ul>
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
<figure class="card rounded p-2 td-post-card mb-4 mt-4" style="max-width: 832px">
|
||
<img class="card-img-top" src="/docs/core_applications/gitea/signin_hu902b849ac1054eab240a0bbe52e46d05_18376_822x311_resize_catmullrom_3.png" width="822" height="311">
|
||
|
||
<figcaption class="card-body px-0 pt-2 pb-0">
|
||
<p class="card-text">
|
||
</p>
|
||
</figcaption>
|
||
|
||
</figure>
|
||
|
||
<p>Then you can set up all the repositories and users you want. Please see the documentation for Gitea linked down below for more information.</p>
|
||
<p><strong>Publishing Websites Using Gitea</strong></p>
|
||
<p>You Federated Core has a facility built in to publish three website from your Gitea repositories to a Caddy webserver using a webhook. What this means, in plain english, is that when you Gitea installation receives a &ldquo;git push&rdquo; to one of these three repositories, it will publish the &ldquo;public&rdquo; folder as a website. (In fact, this documentation is published on a Federated Core using the exact same facility). No more need for Netlify or other static page publishers!</p>
|
||
<p>The &ldquo;gitea&rdquo; user has three repositories. You can add users to these repositories using the standard Gitea commands.</p>
|
||
<p>Say, for example, you want to use <a href="https://gohugo.io/">Hugo</a> to create your website. Copy the URL of the repositor you want to work on.</p>
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
<figure class="card rounded p-2 td-post-card mb-4 mt-4" style="max-width: 768px">
|
||
<img class="card-img-top" src="/docs/core_applications/gitea/repositories_hue92f70f31b9c65953770c15d50d40b3f_40543_758x516_resize_catmullrom_3.png" width="758" height="516">
|
||
|
||
<figcaption class="card-body px-0 pt-2 pb-0">
|
||
<p class="card-text">
|
||
</p>
|
||
</figcaption>
|
||
|
||
</figure>
|
||
|
||
<p>Open the repository you want to use by clicking the link. Then, once in the repository, you can copy the link for cloning&hellip;</p>
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
<figure class="card rounded p-2 td-post-card mb-4 mt-4" style="max-width: 577px">
|
||
<img class="card-img-top" src="/docs/core_applications/gitea/copyhttp_hu3024f7ba98ecc6d8b337da1ab7029aae_12178_567x148_resize_catmullrom_3.png" width="567" height="148">
|
||
|
||
<figcaption class="card-body px-0 pt-2 pb-0">
|
||
<p class="card-text">
|
||
</p>
|
||
</figcaption>
|
||
|
||
</figure>
|
||
|
||
<p>Then, going back to your local development machine (assuming &ldquo;git&rdquo; and &ldquo;hugo&rdquo; are installed), you can issue the following command:</p>
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
<figure class="card rounded p-2 td-post-card mb-4 mt-4" style="max-width: 570px">
|
||
<img class="card-img-top" src="/docs/core_applications/gitea/clone_hu12b5f0d5ee7c0ed748848cbee5c9f680_5495_560x60_resize_catmullrom_3.png" width="560" height="60">
|
||
|
||
<figcaption class="card-body px-0 pt-2 pb-0">
|
||
<p class="card-text">
|
||
</p>
|
||
</figcaption>
|
||
|
||
</figure>
|
||
|
||
<p>You will then have the repository from your Gitea installation on your Federated Core on your local development machine.</p>
|
||
<p>From here you can develop in Hugo as normal, use the local Hugo server to preview your site, then, when ready, push back up to your Gitea installation on your Federated Core. You Gitea will see the &ldquo;push&rdquo; from Git and copy the &ldquo;public&rdquo; directory from your Gitea repository to a Caddy server for publication to the public internet.</p>
|
||
<p>There are three websites/repositories set up for us at this time. They are:</p>
|
||
<ul>
|
||
<li>WWW (publishing to <a href="http://www.domain.com">www.domain.com</a>)</li>
|
||
<li>BLOG (publishing to blog.domain.com)</li>
|
||
<li>DOCUMENTATION (publishing to documentation.domain.com)</li>
|
||
</ul>
|
||
<blockquote>
|
||
<p>Note: this is just the beginning of the scope of this feature on your Federated Core. We&rsquo;d love to hear your feedback and ideas for future development.</p>
|
||
</blockquote>
|
||
<p><strong>Gitea Documentation</strong></p>
|
||
<p>You can learn more about Gitea <a href="https://docs.gitea.com/category/usage">at this link</a>.</p>
|
||
|
||
</description>
|
||
</item>
|
||
|
||
<item>
|
||
<title>Docs: Jitsi</title>
|
||
<link>/docs/core_applications/jitsi/</link>
|
||
<pubDate>Thu, 05 Jan 2017 00:00:00 +0000</pubDate>
|
||
|
||
<guid>/docs/core_applications/jitsi/</guid>
|
||
<description>
|
||
|
||
|
||
|
||
|
||
<div class="pageinfo pageinfo-primary">
|
||
<p>This documentation is for users and administrators, not those wanting to install.</p>
|
||
|
||
</div>
|
||
|
||
<p>Access to Jitsi is at: <a href="https://jitsi.domain.com">https://jitsi.domain.com</a> where &ldquo;domain.com&rdquo; is your domain name.</p>
|
||
<p>Your Federated Core includes a full-featured open-source video conferencing solution &ldquo;Jitsi&rdquo;.</p>
|
||
<p><strong>Constraints</strong></p>
|
||
<p>Your Jitsi installation has been optimized and tuned for teams and can support up to 8 people on a conference using video and audio. These numbers are dependent on the amount of bandwidth available to each participant and network conditions between the participants. If you would like to build out capacity for larger video conferences, please contact us for support.</p>
|
||
<p><strong>Credentials</strong></p>
|
||
<p>While anyone in the world can participate in a Jitsi meeting, only a person with an account on your Federated Core can start a Jitsi meeting.</p>
|
||
<p>As of today, Jitsi is the <em>one</em> service in Federated Core that does <em>not</em> use your email address for log in. If your email address, for example, is &ldquo;<a href="mailto:david@rewind.com">david@rewind.com</a>&rdquo;, your Jitsi username would be &ldquo;david&rdquo;. Your password is the same as other Federated Core services.</p>
|
||
<p>Username: name without your domain name.
|
||
Password: your password.</p>
|
||
<p><strong>Starting A Meeting</strong></p>
|
||
<p>Simply go to the Jitsi application on your Federated Core. You start a meeting by giving it a name.</p>
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
<figure class="card rounded p-2 td-post-card mb-4 mt-4" style="max-width: 646px">
|
||
<img class="card-img-top" src="/docs/core_applications/jitsi/meeting_hu250e0e08c5a457d68556c942351f1838_184038_636x318_resize_catmullrom_3.png" width="636" height="318">
|
||
|
||
<figcaption class="card-body px-0 pt-2 pb-0">
|
||
<p class="card-text">
|
||
</p>
|
||
</figcaption>
|
||
|
||
</figure>
|
||
|
||
<blockquote>
|
||
<p>Tip: these names can &ldquo;persist&rdquo;, so you can treat them like &ldquo;conference rooms&rdquo; and re-use them over-and-over. For example, name your meeting &ldquo;customerservice&rdquo; and then the URL &ldquo;<a href="https://jitsi.domain.com/customerservice%22">https://jitsi.domain.com/customerservice&quot;</a> (where &ldquo;domain.com&rdquo; is your domain name) can be accessed easily, posted somewhere for later reference/use, etc.</p>
|
||
</blockquote>
|
||
<p>You are then asked for the name you want to use for the meeting. This can be whatever you want.</p>
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
<figure class="card rounded p-2 td-post-card mb-4 mt-4" style="max-width: 509px">
|
||
<img class="card-img-top" src="/docs/core_applications/jitsi/join_huf0193cf0f5da1432c50d07c514b7603a_97361_499x452_resize_catmullrom_3.png" width="499" height="452">
|
||
|
||
<figcaption class="card-body px-0 pt-2 pb-0">
|
||
<p class="card-text">
|
||
</p>
|
||
</figcaption>
|
||
|
||
</figure>
|
||
|
||
<p>You may be asked if you are the &ldquo;host&rdquo; for the meeting. Click &ldquo;I am the host.&rdquo;</p>
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
<figure class="card rounded p-2 td-post-card mb-4 mt-4" style="max-width: 425px">
|
||
<img class="card-img-top" src="/docs/core_applications/jitsi/host_hue23bdd1f4fa669b230514cc818ca23f6_24929_415x214_resize_catmullrom_3.png" width="415" height="214">
|
||
|
||
<figcaption class="card-body px-0 pt-2 pb-0">
|
||
<p class="card-text">
|
||
</p>
|
||
</figcaption>
|
||
|
||
</figure>
|
||
|
||
<p>Then you will be asked to authenticate so that just anyone off the internet can&rsquo;t use your Federated Core for meeting.</p>
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
<figure class="card rounded p-2 td-post-card mb-4 mt-4" style="max-width: 430px">
|
||
<img class="card-img-top" src="/docs/core_applications/jitsi/login_hu884e309127a9f6347ff31f77a5d3886c_24816_420x325_resize_catmullrom_3.png" width="420" height="325">
|
||
|
||
<figcaption class="card-body px-0 pt-2 pb-0">
|
||
<p class="card-text">
|
||
</p>
|
||
</figcaption>
|
||
|
||
</figure>
|
||
|
||
<p>As stated above, your user name will be the part <em>before</em> the &ldquo;@&rdquo; symbol in your Federated Core email address. This is the only service, currently, on Federated Core that works this way. Your password is your password.</p>
|
||
<p><strong>Official Jitsi User Documentation</strong></p>
|
||
<p>Here is the <em>official</em> Jitsi <a href="https://jitsi.github.io/handbook/docs/user-guide/">user documentation</a>.</p>
|
||
|
||
</description>
|
||
</item>
|
||
|
||
<item>
|
||
<title>Docs: Nextcloud</title>
|
||
<link>/docs/core_applications/nextcloud/</link>
|
||
<pubDate>Thu, 05 Jan 2017 00:00:00 +0000</pubDate>
|
||
|
||
<guid>/docs/core_applications/nextcloud/</guid>
|
||
<description>
|
||
|
||
|
||
|
||
|
||
<div class="pageinfo pageinfo-primary">
|
||
<p>This documentation is for users and administrators, not those wanting to install.</p>
|
||
|
||
</div>
|
||
|
||
<p>Access to Nextcloud is at: <a href="https://nextcloud.domain.com">https://nextcloud.domain.com</a> where &ldquo;domain.com&rdquo; is your domain name.</p>
|
||
<p>Nextcloud provides a rich set of groupware solutions for your team. It is comprised of some key core-applications and can be extended by the administrative user.</p>
|
||
<p>The purpose of this document is <em>not</em> to provide documentation on Nextcloud or the Nextcloud applications, but to provide tips about your Federated Core installation of Nextcloud.</p>
|
||
<p><strong>Warnings for the Administrative User</strong>*</p>
|
||
<blockquote>
|
||
<p>Note: if you sign into Nextcloud as your administrative user, it is possible to compromise and destroy the installation. We hope to correct this in future versions of Federated Core. However, we wanted to provide you with the flexibility to theme Nextcloud, change certain behaviors, messages, etc.</p>
|
||
</blockquote>
|
||
<blockquote>
|
||
<p>Warning: do NOT change the LDAP/AD Integration settings. This will disconnect your Nextcloud installation from your Federated Core user management features.</p>
|
||
</blockquote>
|
||
<blockquote>
|
||
<p>Note: users are NOT created in Nextcloud, they are create in Panel so that those user accounts are available to other applications and service on your Federated Core.</p>
|
||
</blockquote>
|
||
<p>A brief overview of the Nextcloud applications.</p>
|
||
<p><strong>Dashboard</strong></p>
|
||
<p>The dashboard application gives users a quick overview of recent files, any mentions in the Talk application, and a widget for the calendar. You can set your location for the weather (it is a forecast, not current weather), and the ability to customize your dashboard.</p>
|
||
<p><strong>Mail</strong></p>
|
||
<p>The first time you load the web client for Mail, you will need to accept the &ldquo;automatic&rdquo; settings for your mail server. Mail is a full-featured webmail client. Each message can be tagged, an event can be created from the message (using the &ldquo;triple dot&rdquo; menu).</p>
|
||
<p><strong>Calendar</strong></p>
|
||
<p>In Calendar you will see your personal calendar and any calendars for &ldquo;decks&rdquo; (project management). There is also functionality for &ldquo;Appointments&rdquo; allowing you to set up times that others can schedule time with you.</p>
|
||
<p><strong>Contacts</strong></p>
|
||
<p>Contacts is your address book for all the people you interact with digitally.</p>
|
||
<p><strong>Notes</strong></p>
|
||
<p>Notes is a place to write text documents using &ldquo;text&rdquo; or &ldquo;markdown&rdquo; format (depending on your choice in the &ldquo;Notes Settings&rdquo;).</p>
|
||
<blockquote>
|
||
<p>Tip. If you want to share a note with team members or people outside your team/domain, that is done in the &ldquo;Files&rdquo; application. Your notes will be found there in the &ldquo;Notes&rdquo; folder.</p>
|
||
</blockquote>
|
||
<p><strong>Tasks</strong></p>
|
||
<p>A great &ldquo;to-do&rdquo; list. You can use this as a list of reminders, another way to do project management, and collaborate with your team.</p>
|
||
<p><strong>Files</strong></p>
|
||
<p>Works just like Google Drive or Dropbox. However, it has a secret power built in. Client on the big &ldquo;plus&rdquo; at the top of the screen to create and edit, in the browser, documents fully compatible with Microsoft Office 365 and Libre Office.</p>
|
||
<p>You can install and configure applications for MacOS, Windows, Linux, and the mobile device platforms providing real-time sync of your files across all your devices.</p>
|
||
<p><strong>Deck</strong></p>
|
||
<p>This is an amazing Kanban-type application for organizing and managing any project. You create columns of &ldquo;stages&rdquo; according to your needs across which you can move &ldquo;task&rdquo; or &ldquo;work&rdquo; cards. You can futher use &ldquo;tags&rdquo; to get additional dimensions to your project &ldquo;tasks&rdquo;.</p>
|
||
<p><strong>Bookmarks</strong></p>
|
||
<p>Capture website URLs and organize them into groups. If you want previews, you will need to add a service like <a href="https://3.screeenly.com/">Screeenly</a> to your installation. You can do this with your admin account in &ldquo;Administrative Settings &gt; Bookmarks&rdquo;.</p>
|
||
<p><strong>Forms</strong></p>
|
||
<p>Allows you to create simple forms for capturing data from those both inside and outside of your team/domain. For example, want to do a survey, use forms.</p>
|
||
<p><strong>Talk</strong></p>
|
||
<p>This is a full-featured chat application for your Nextcloud installation. While you also have an industrial-strength chat/communications platform with Element/Matrix, you can use Nextcloud Talk to chat about files, and other objects without Nextcloud itself.</p>
|
||
<p><strong>Photos</strong></p>
|
||
<p>Duh.</p>
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
<figure class="card rounded p-2 td-post-card mb-4 mt-4" style="max-width: 2155px">
|
||
<img class="card-img-top" src="/docs/core_applications/nextcloud/mountains_hu8565b7a34ca6627a5cd63a5e836fe2f7_586983_2145x1398_resize_q75_catmullrom.jpg" width="2145" height="1398">
|
||
|
||
<figcaption class="card-body px-0 pt-2 pb-0">
|
||
<p class="card-text">
|
||
</p>
|
||
</figcaption>
|
||
|
||
</figure>
|
||
|
||
<p><strong>Activity</strong></p>
|
||
<p>See what is going on across all the different parts of your Nextcloud installation.</p>
|
||
<p><strong>Quick Links to Other Federated Core Services</strong></p>
|
||
<p>In the top left corner of the Nextcloud web interface is a icon looking like a grid of squares. Click on the grid to get access to a list of the other services in your Federated Core.</p>
|
||
<p><strong>Official Nextcloud User Documentation</strong></p>
|
||
<p>For additional information about using Baserow, please consult the <a href="https://docs.nextcloud.com/server/latest/user_manual/en/">user documentation</a>.</p>
|
||
|
||
</description>
|
||
</item>
|
||
|
||
</channel>
|
||
</rss>
|