path: root/doc/member/member_guide.html

<p><strong>Table of Contents</strong></p>

<ul id="member-guide-toc"> 
    <li><a href="/help/member/member_guide#overview">Overview</a></li>
    <li><a href="/help/member/member_guide#Registration">Registration</a></li>
    <li><a href="/help/member/member_guide#Profiles">Profiles</a></li>
    <li><a href="/help/member/member_guide#Channels">Channels</a></li>
    <li><a href="/help/member/member_guide#roles">Account Permission Roles</a></li>
    <li><a href="/help/member/member_guide#connecting-to-channels">Connecting To Channels</a></li>
    <li><a href="/help/member/member_guide#permissions">Permissions and Access Control</a></li>
    <li><a href="/help/member/member_guide#cloud-storage">Cloud Storage</a></li>
    <li><a href="/help/member/member_guide#remove-channel">Remove Channel or Account</a></li>
</ul>

<hr>

<h1 id="overview">Overview</h1>
<p> While many features and capabilities of
Hubzilla are familiar to people who have used social networking sites and
blogging software, there are also quite a few new concepts and features that
most people have not encountered before. Some of the new ideas are related to
the <strong>decentralized</strong> nature of the grid; others are associated
with the advanced <strong>permissions system</strong> that is necessary to
protect your data privacy. The purpose of this guide is to help you understand
how to create, configure, and use your nomadic identity. </p>


<h1 id="Registration">Registration</h1>
Not all Hubzilla sites allow open
registration. If registration is allowed, you will see a "Register" link
immediately below the login prompts on the site home page. Following this link
will take you to the site Registration page. On some sites it may redirect you
to another site which allow registrations. As all Hubzilla sites are linked, it
does not matter where your account resides.<br><br><strong>Your Email
Address</strong><br><br>Please provide a valid email address. Your email address
is never published. This address will be used to activate your account, to
(optionally) send email notifications for incoming messages or items, <em>and to
recover lost passwords</em>.<br><br><strong>Password</strong><br><br>Enter a
password of your choice, and repeat it in the second box to ensure it was typed
correctly. As Hubzilla offers a decentralised identity, your account can log you
in to many other websites.<br><br><strong>Terms Of Service</strong><br><br>Click
the link to read the site's <a class="zrl"
href="[baseurl]/help/TermsOfService">Terms of Service</a>. Once you've read
them, tick the box in the register form to
confirm.<br><br><strong>Register</strong><br><br>Once you have provided the
necessary details, click the 'Register' button. Some sites may require
administrator approval before the registration is processed, and you will be
alerted if this is the case. Please watch your email (including spam folders)
for your registration approval.<br><br><strong>Create a
Channel</strong><br><br>Next, you will be presented with the "Add a channel"
screen. Normally, your first channel will be one that represents you - so using
your own name (or psuedonym) as the channel name is a good idea. The channel
name should be thought of as a title, or brief description of your channel. The
"choose a short nickname" box is similar to a "username" field. We will use
whatever you enter here to create a channel address, which other people will use
to connect to you, and you will use to log in to other sites. This looks like an
email address, and takes the form nickname@siteyouregisteredat.xyz<br><br>When
your channel is created you will be taken straight to your settings page where
you can define permissions, enable features, etc. All these things are covered
in the appropriate section of the helpfiles.<br><br>See Also<br><a class="zrl"
href="[baseurl]/help/accounts_profiles_channels_basics">The Basics about
Identities within Hubzilla</a><br><a class="zrl"
href="[baseurl]/help/accounts">Accounts</a><br><a class="zrl"
href="[baseurl]/help/profiles">Profiles</a><br><a class="zrl"
href="[baseurl]/help/permissions">Permissions</a><br><a class="zrl"
href="[baseurl]/help/remove_account">Remove Account</a>

<h1 id="Profiles">Profiles</h1>
Hubzilla has unlimited profiles. You may use
different profiles to show different "sides of yourself" to different audiences.
This is different to having different channels. Different channels allow for
completely different sets of information. You may have a channel for yourself, a
channel for your sports team, a channel for your website, or whatever else. A
profile allows for finely graded "sides" of each channel. For example, your
default public profile might say "Hello, I'm Fred, and I like laughing". You may
show your close friends a profile that adds "and I also enjoy dwarf
tossing".<br><br>You always have a profile known as your "default" or "public"
profile. This profile is always available to the general public and cannot be
hidden (there may be rare exceptions on privately run or disconnected sites).
You may, and probably should restrict the information you make available on your
public profile.<br><br>That said, if you want other friends to be able to find
you, it helps to have the following information in your public
profile...<br><br><ul class="listbullet" style="list-style-type:
circle;"><li>Your real name or at least a nickname everybody knows<br></li><li>A
photo of you<br></li><li>Your location on the planet, at least to a country
level.</li></ul><br><br>In addition, if you'd like to meet people that share
some general interests with you, please take a moment and add some "Keywords" to
your profile. Such as "music, linux, photography" or whatever. You can add as
many keywords as you like.<br><br>To create an alternate profile, first go to <a
class="zrl" href="[baseurl]/settings/features">Settings &gt; Additional
Features</a> and enable "Multiple Profiles" there, otherwise you won't have the
ability to use more than just your default profile.<br><br>Then select "Edit
Profiles" from the menu of your Hubzilla site. You may edit an existing profile,
change the profile photo, add things to a profile or create a new profile. You
may also create a "clone" of an existing profile if you only wish to change a
few items but don't wish to enter all the information again. To do that, click
on the profile you want to clone and choose "Clone this profile"
there.<br><br>In the list of your profiles, you can also choose the contacts who
can see a specific profile. Just click on "Edit visibility" next to the profile
in question (only available for the profiles that are not your default profile)
and then click on user images to add them to or remove them from the group of
people who can see this profile.<br><br>Once a profile has been selected, when
the person views your profile, they will see the private profile you have
assigned. If they are not authenticated, they will see your public
profile.<br><br>There is a setting which allows you to publish your profile to a
directory and ensure that it can be found by others. You can change this setting
on the "Settings" page.<br><br>If you do not wish to be found be people unless
you give them your channel address, you may leave your profile
unpublished.<br><br><strong>Keywords and Directory Search</strong><br><br>On the
directory page, you may search for people with published profiles. Currently,
only the name field and the keywords are searched.&nbsp;&nbsp;You may also
include such keywords in your default profile - which may be used to search for
common interests with other members. Keywords are used in the channel suggestion
tool and although they aren't visible in the directory, they are shown if people
visit your profile page.<br><br>On your Connnections page and in the directory
there is a link to "Suggestions" or "Channel Suggestions", respectively. This
will find channels who have matching and/or similar keywords. The more keywords
you provide, the more relevant the search results that are returned. These are
sorted by relevance.<br><br>See Also<br><br><a class="zrl"
href="[baseurl]/help/AdvancedSearch">Advanced Searching</a>

<h1 id="Channels">Channels</h1>
<h3>What are channels?</h3> Channels are simply
collections of content stored in one place. A channel can represent anything. It
could represent you, a website, a forum, photo albums, anything. For most
people, their first channel with be "Me".<br><br>The most important features for
a channel that represents "me" are:<br><ul class="listbullet"
style="list-style-type: circle;"><br><li>Secure and private "spam free"
communications<br><br></li><li>Identity and "single-signon" across the entire
network<br><br></li><li>Privacy controls and permissions which extend to the
entire network<br><br></li><li>Directory services (like a phone
book)<br></li></ul><br>In short, a channel that represents yourself is "me, on
the internet".<br><br><h3>Creating channels</h3><br><br>You will be required to
create your first channel as part of the sign up process. You can also create
additonal channels from the "Select channel" link.<br><br>You will be asked to
provide a channel name, and a short nick name. For a channel that represents
yourself, it is a good idea to use your real name here to ensure your friends
can find you, and connect to your channel. The short nickname will be used to
generate a "webbie". This is a bit like a username, and will look like an email
address, taking the form nickname@domain. You should put a little thought into
what you want to use here. Imagine somebody asking for your webbie and having to
tell them it is "llamas-are_kewl.123". "llamasarecool" would be a much better
choice.<br><br>Once you have created your channel, you will be taken to the
settings page, where you can configure your channel, and set your default
permissions.<br><br>Once you have done this, your channel is ready to use. At
[observer=1]<a
href="[observer.url]">[observer.url]</a>[/observer][observer=0]example.com/
channel/username[/observer] you will find your channel "stream". This is where
your recent activity will appear, in reverse chronological order. If you post in
the box marked "share", the entry will appear at the top of your stream. You
will also find links to all the other communication areas for this channel here.
The "About" tab contains your "profile", the photos page contain photo albums,
and the events page contains events share by both yourself and your
contacts.<br><br><h3>The grid, permissions and delegation</h3><br><br>The "Grid"
page contains all recent posts from across Hubzilla network, again in reverse
chronologial order. The exact posts that appear here depend largely on your
permissions. At their most permissive, you will receive posts from complete
strangers. At the other end of the scale, you may see posts from only your
friends - or if you're feeling really anti-social, only your own
posts.<br><br>As mentioned at the start, many other kinds of channel are
possible, however, the creation procedure is the same. The difference between
channels lies primarily in the permissions assigned. For example, a channel for
sharing documents with colleagues at work would probably want more permissive
settings for "Can write to my "public" file storage" than a personal account.
For more information, see the <a class="zrl"
href="[baseurl]/help/roles">permissions section</a>.<br><br>You can also
delegate control of your channels' posts and connections, but not its
configurations, to another channel. That is done by editing a connection and
assigning it the permission to administer your channel's resources.



<h1 id="roles">Account Permission Roles</h1>

<h2>Social</h2>

<p><strong>Mostly Public</strong></p>

<p>The channel is a typical social networking profile. By default posts and published items are public, but one can over-ride this when creating the item and restrict it. You are listed in the directory. Your online presence and connections are visible to others.</p>

<p><strong>Restricted</strong></p>

<p>By default all posts and published items are sent to your 'Friends' privacy group and not made public. New friends are added to this privacy group. You can over-ride this and create a public post or published item if you desire. You are listed in the directory. Your online presence (for chat) and your connections (friends) are visible to your profile viewers.</p>

<p><strong>Private</strong></p>

<p>By default all posts and published items are sent to your 'Friends' privacy group. New friends are added to this privacy group. You can over-ride this and create a public post or public item if you desire. You are NOT listed in the directory. Only your connections can see your other connections. Your online presence is hidden.</p>

<h2>Forum</h2>

<p><strong>Mostly Public</strong></p>

<p>The channel is a typical forum. By default posts and published items are public. Members may post by @mention+ or wall-to-wall post. Posting photos and other published items is blocked. The channel is visible in the directory. Members are added automatically.</p>

<p><strong>Restricted</strong></p>

<p>By default all posts and published items are sent to the channel's 'Friends' privacy group. New friends are added to this privacy group. Members may post by @mention+ or wall-to-wall post, but posts and replies may also be seen by other receipients of the top-level post who are not members. The channel is visible in the directory. Members must be manually added by the forum owner.</p>

<p><strong>Private</strong></p>

<p>By default all posts and published items are sent to your 'Friends' privacy group. New friends are added to this privacy group. The owner can over-ride this and create a public post or public item if desired. Members cannot. You are NOT listed in the directory. Only your connections can see your other connections. Your online presence is hidden. Members must be manually added by the forum owner. Posting by @mention+ is disabled. Posts can only be made via wall-to-wall posts, and sent to members of the 'Friends' privacy group. They are not publicly visible.</p>

<h2>Feed</h2>

<p><strong>Public</strong></p>

<p>Similiar to Social - Mostly Public, but tailored for RSS feed sources. Items may be freely republished and sourced. Online presence is meaningless, therefore hidden. New connections are automatically approved.</p>

<p><strong>Restricted</strong></p>

<p>Not listed in directory. Online presence is meaningless, therefore hidden. Feed is published only to members of the 'Friends' privacy group. New connections are automatically added to this privacy group. Members must be manually approved by the channel owner.</p>

<h2>Special</h2>

<p><strong>Celebrity/Soapbox</strong></p>

<p>Listed in directory. Communications are by default public. Online presence is hidden. No commenting or feedback of any form is allowed, though connections have the ability to "like" your profile.</p>

<p><strong>Group Repository</strong></p>

<p>A public forum which allows members to post files/photos/webpages.</p>

<h2>Custom/Expert Mode</h2>

<p>Set all the privacy and permissions manually to suit your specific needs.</p>


<h1 id="connecting-to-channels">Connecting To Channels</h1>

<p>Connections in Hubzilla can take on a great many different meanings. But let's keep it simple, you want to be friends with somebody like you are familiar with from social networking. How do you do it?</p>

<p>First, you need to find some channels to connect to.  There are two primary ways of doing this.  Firstly, setting the "Can send me their channel stream and posts" permission to "Anybody in this network" will bring posts from complete strangers to your matrix.  This will give you a lot of public content and should hopefully help you find interesting, entertaing people, forums, and channels.</p>

<p>The next thing you can do is look at the Directory.  The directory is available on every Hubzilla website which means searching from your own site will bring in results from the entire network.  You can search by name, interest, location and keyword.  This is incomplete, so we'll improve this paragraph later.</p>

<p>To connect with other Hubzilla channels:</p>

<p>Visit their profile by clicking their photograph in the directory, matrix, or comments, and it will open their channel home page in the channel viewer.  At the left hand side of the screen, you will usually see a link called "connect".  Click it, and you're done.  Depending on the settings of the channel you are connecting to, you may need to wait for them to approve your connection, but no further action is needed on your part. Once you've initiated the connection, you will be taken to the connection editor. This allows you to assign specific permissions for this channel. If you don't allow any permissions, communication will be very limited. There are some quick links which you can use to avoid setting individual permissions. To provide a social network environment, "Full Sharing" is recommended. You may review the settings that are applied with the quick links to ensure they are suitable for the channel you are connecting with and adjust if necessary. Then scroll to the bottom of the page and click "Submit".</p>

<p>You may also connect with any channel by visiting the "Connections" page of your site or the Directory and typing their "webbie" into the "Add New Connection" field. Use this method if somebody tells you their webbie and you wish to connect with them. A webbie looks like an email address; for example "bob@example.com". The process is the same as connecting via the "Connect" button - you will then be taken to the connection editor to set permissions.</p>

<h2>Block/Ignore/Archive/Hide channels</h2>

<p>Channels in your address book can have statuses such as <em>blocked</em>, <em>ignored</em>, <em>archived</em> and <em>hidden</em>. From your connections page you can see tabs that display the channels with those statuses. From your edit connection pages you can change the statuses of a channel.</p>

<p>Here's their meaning:</p>

<p><strong>Blocked:</strong> the channel can't read your items regardless of permissions, nor can it write to your channel.</p>

<p><strong>Ignored:</strong> the channel can read your items if it has permission, but can't write to your channel.</p>

<p><strong>Hidden:</strong> the channel does not show up in your profile's connections list, noone can see you're connected, but beware they may still show up to your other connections, for example in post replies.</p>

<p><strong>Archived:</strong> if a channel can't be reached for 30 days, it is automatically marked as archived. This keeps all the data but stops polling the channel for new information and removes it from autocomplete. If later you learn the channel has come back online, you may manually unarchive it.</p>

<h2>Premium Channels</h2>

<p>Some channels are designated "Premium Channels" and <strong>may</strong> require some action on your part before a connection can be established. The Connect button will for these channels will take you to a page which lists in detail what terms the channel owner has set. If the terms are accepted, the connection will then proceed normally. In some cases, such as with celebrities and world-reknowned publishers, this <strong>may</strong> involve payment. If you do not agree to the terms, the connection will not proceed, or it may proceed but with reduced permissions allowed on your interactions with that channel.</p>


<h1 id="permissions">Permissions and Access Control</h1>

<br>Permissions in Hubzilla are more complete than you may be used to. This allows us to define more fine graded relationships than the black and white "this person is my friend, so they can do everything" or "this person is not my friend, so they can't do anything" permissions you may find elsewhere.<br><br><strong>Permission Roles</strong><br><br>When you create a channel we allow you to select different 'roles' for that channel. These create an entire family of permissions and privacy settings that are appropriate for that role. Typical roles are "Social - mostly public", "Social - mostly private", "Forum - public" and many others. These bring a level of simplicity to managing permissions. Just choose a role and appropriate permissions are automatically applied. You can also choose 'Custom/Expert mode' and change any individual permission setting in any way you desire. <br><br><br><strong>Default Permission Limits</strong><br><br>There are a large number of individual permissions. These control everything from the ability to view your stream to the ability to chat with you. Every permission has a limit. The scope of these permissions varies from "Only me" to "Everybody on the internet" - though some scopes may not be available for some permissions. The limit applies to any published thing you create which has no privacy or access control. For example if you publish a photo and didn't select a specific audience with permission to view it, we apply the limit. These limits apply to everything within that permission rule, so you cannot apply a limit to one photo. The limit applies to all your photos. If all your photos are visible to everybody on the internet and you reduce the limit only to friends, <strong>all</strong> of your photos will now be visible only to friends.<br><br><strong>Access Control</strong><br> <br>Access Control is the preferred method of managing privacy in <em>most</em> cases, rather than using permission limits. This creates lists of either connections or privacy groups (or both) and uses the access list to decide if a permission is allowed. An access list is attached to everything you publish. Unlike permission limits, if you change the access control list on a single photo, it doesn't affect any of your other photos. You can use privacy groups and a "default access control list" to create and automate the management of access control lists to provide any level of privacy you desire on anything you publish. <br><br>We highly recommend that you use the "typical social network" settings when you create your first channel, as it allows others to communicate with you and help you out if you have difficulty. You will find that these settings allow you as much privacy as you desire - when you desire it; but also allow you to communicate in public if you choose to. You are free to use much more private settings once you have learned your way around.<br><br><br><dl class="bb-dl dl-terms-large">
<dt> The scopes of permissions are:</dt><dd><br><dl class="bb-dl dl-terms-italic">
<dt> Nobody Except Yourself </dt><dd> This is self explanatory. Only you will be allowed access.<br>&nbsp;&nbsp;<br></dd>
<dt> Only those you specifically allow </dt><dd> By default, people you are not connected to, and all new contacts will&nbsp;&nbsp; have this permission denied. You will be able to make exceptions for individual channels on their contact edit&nbsp;&nbsp; screen.<br>&nbsp;&nbsp;<br></dd>
<dt> Anybody in your address book </dt><dd> Anybody you do not know will have this permission denied, but anybody you&nbsp;&nbsp; accept as a contact will have this permission approved. This is the way most legacy platforms handle&nbsp;&nbsp; permissions.<br>&nbsp;&nbsp;<br></dd>
<dt> Anybody On This Hub </dt><dd> Anybody with a channel on the same hub/website as you will have permission approved. Anybody who is registered at a different hub will have this permission denied.<br>&nbsp;&nbsp;<br></dd>
<dt> Anybody in this network </dt><dd> Anybody in Hubzilla will have this permission approved. Even complete&nbsp;&nbsp; strangers. However, anybody not logged in/authenticated will have this permission denied.<br>&nbsp;&nbsp;<br></dd>
<dt> Anybody authenticated </dt><dd> This is similar to "anybody in this network" except that it can include anybody&nbsp;&nbsp; who can authenticate by any means - and therefore <em>may</em> include visitors from other networks.<br>&nbsp;&nbsp;<br></dd>
<dt> Anybody on the internet </dt><dd> Completely public. This permission will be approved for anybody at all.<br></dd></dl><br></dd>
<dt> The individual permissions are:</dt><dd><br><dl class="bb-dl dl-terms-italic">
<dt> Can view my "public" stream and posts. </dt><dd> This permision determines who can view your channel "stream" that is, the non-private posts that appear on the "home" tab when you're logged in.<br><br></dd>
<dt> Can view my "public" channel profile. </dt><dd> This permission determines who can view your channel's profile. This refers to the "about" tab<br><br></dd>
<dt> Can view my "public" photo albums. </dt><dd> This permission determines who can view your photo albums. Individual photographs may still be posted to a more private audience.<br><br></dd>
<dt> Can view my "public" address book. </dt><dd> This permission determines who can view your contacts. These are the connections displayed in the "View connections" section.<br><br></dd>
<dt> Can view my "public" file storage. </dt><dd> This permission determines who can view your public files stored in your cloud.<br><br></dd>
<dt> Can view my "public" pages. </dt><dd> This permission determines who can view your public web pages. <br><br></dd>
<dt> Can send me their channel stream and posts. </dt><dd> This permission determines whose posts you will view. If your channel is a personal channel (ie, you as a person), you would probably want to set this to "anyone in my address book" at a minimum. A personal notes channel would probably want to choose "nobody except myself". Setting this to "Anybody in the network" will show you posts from complete strangers, which is a good form of discovery.<br><br></dd>
<dt> Can post on my channel page ("wall"). </dt><dd> This permission determines who can write to your wall when clicking through to your channel.<br><br></dd>
<dt> Can comment on my posts. </dt><dd> This permission determines who can comment on posts you create. Normally, you would want this to match your "can view my public stream and posts" permission<br><br></dd>
<dt> Can send me private mail messages. </dt><dd> This determines who can send you private messages (zotmail).<br><br></dd>
<dt> Can post photos to my photo albums. </dt><dd> This determines who can post photographs in your albums. This is very useful for forum-like channels where connections may not be connected to each other.<br><br></dd>
<dt> Can forward to all my channel contacts via post tags. </dt><dd> Using @- mentions will reproduce a copy of your post on the profile specified, as though you posted on the channel wall. This determines if people can post to your channel in this way.<br><br></dd>
<dt> Can chat with me (when available). </dt><dd> This determines who can join the public chat rooms created by your channel.<br><br></dd>
<dt> Can write to my "public" file storage. </dt><dd> This determines who can upload files to your public file storage, or 'cloud'.<br><br></dd>
<dt> Can edit my "public" pages. </dt><dd> This determines who can edit your webpages. This is useful for wikis or sites with multiple editors.<br><br></dd>
<dt> Can administer my channel resources. </dt><dd> This determines who can have full control of your channel. This should normally be set to "nobody except myself".<br></dd></dl></dd></dl><br><em>Note:</em><br>Plugins/addons may provide special permission settings, so you may be offered additional permission settings beyond what is described here.<br><br>If you have set any of these permissions to "only those I specifically allow", you may specify indivudal permissions on the connnection edit screen.<br><br><strong>Affinity</strong><br><br>The connection edit screen offers a slider to select a degree of friendship with the connnection (this tool is enabled through the "Extra Features" tab of your Settings page). Think of this as a measure of how much you like or dislike them. 1 is for people you like, whose posts you want to see all the time. 99 is for people you don't care for, and whose posts you might only wish to look at occasionally. Once you've assigned a value here, you can use the affinity tool on the matrix page to filter content based on this number.<br><br>The slider on the matrix page has both a minimum and maximum value. Posts will only be shown from people who fall between this range. Affinity has no relation to permissions, and is only useful in conjunction with the affinity tool feature.
	

<h1 id="cloud-storage">Cloud Storage</h1>

<br><br>Hubzilla provides an ability to store privately and/or share arbitrary
files with friends.<br><br>You may either upload files from your computer into
your storage area, or copy them directly from the operating system using the
WebDAV protocol.<br><br>On many public servers there may be limits on disk
usage.<br><br><strong>File Attachments</strong><br><br>The quickest and easiest
way to share files is through file attachments. In the row of icons below the
status post editor is a tool to upload attachments. Click the tool, select a
file and submit. After the file is uploaded, you will see an attachment code
placed inside the text region. Do not edit this line or it may break the ability
for your friends to see the attachment. You can use the post permissions
dialogue box or privacy hashtags to restrict the visibility of the file - which
will be set to match the permissions of the post your are sending.<br><br>To
delete attachments or change the permissions on the stored files, visit <a
href="[baseurl]/cloud/">[baseurl]/cloud/</a>[observer.webname]".<br><br><strong>Web
Access</strong><br><br>Your files are visible on the web at the location
"cloud/[observer.webname]" to anybody who is allowed to view them. If the viewer has
sufficient privileges, they may also have the ability to create new files and
folders/directories.<br><br><strong>WebDAV access</strong><br><br>See: <a
class="zrl" href="/help/member/member_guide#cloud-storage-clients">Cloud Desktop
Clients</a><br><br><strong>Permissions</strong><br><br>When using WebDAV, the
file is created with your channel's default file permissions and this cannot be
changed from within the operating system. It also may not be as restrictive as
you would like. What we've found is that the preferred method of making files
private is to first create folders or directories; then visit
"filestorage/[observer.webname]"; select the directory and change the permissions. Do
this before you put anything into the directory. The directory permissions take
precedence so you can then put files or other folders into that container and
they will be protected from unwanted viewers by the directory permissions. It is
common for folks to create a "personal" or "private" folder which is restricted
to themselves. You can use this as a personal cloud to store anything from
anywhere on the web or any computer and it is protected from others. You might
also create folders for "family" and "friends" with permission granted to
appropriate privacy groups.

<h2 id="cloud-storage-clients">Cloud Desktop Clients</h2>

<h3>Windows Clients</h3>

<h4>Windows Internal Client</h4>

RedDav using
Windows 7 graphical user interface wizard:<br>1. Left-click the Start-button to
open the start menu.<br>2. Right-click the My computer icon to access its
menu.<br>3. Left-click Map network drive... to open the connection dialog
wizard.<br>4. Type <span class="bookmark-identifier">#^</span><a
class="bookmark"
href="https://example.net/dav/your_channel_name">https://example.net/dav/
your_channel_name</a> in the textbox and click the Complete button where
"example.net" is the URL of your hub.<br>5. Type your Hubzilla account's user
name. IMPORTANT - NO at-sign or domain name.<br>6. Type your Hubzilla
password


<h3>Linux Clients</h3>

<h4>Mounting As A Filesystem</h4>

To install your cloud directory as a filesystem, you first need davfs2
installed.&nbsp;&nbsp;99% of the time, this will be included in your
distributions repositories.&nbsp;&nbsp;In Debian<br><br><code
class="inline-code">apt-get install davfs2</code><br><br>If you want to let
normal users mount the filesystem<br><br><code
class="inline-code">dpkg-reconfigure davfs2</code><br><br>and select "yes" at
the prompt.<br><br>Now you need to add any user you want to be able to mount dav
to the davfs2 group<br><br><code class="inline-code">usermod -aG davfs2
&lt;DesktopUser&gt;</code><br><br><strong>Note:</strong> on some systems the
user group may be different, i.e. - "network" <br>on Arch Linux. If in doubt,
check the davfs documentation for your <br>particular OS.<br><br>Edit
/etc/fstab<br><br><code class="inline-code">nano /etc/fstab</code><br><br> to
include your cloud directory by adding<br><br><code><br><a
href="[baseurl]/dav/">[baseurl]/dav/</a> /mount/point
davfs user,noauto,uid=&lt;DesktopUser&gt;,file_mode=600,dir_mode=700 0
1<br></code><br><br>Where <a
href="[baseurl]">[baseurl]</a> is the URL of your hub,
/mount/point is the location you want to mount the cloud, and
&lt;DesktopUser&gt; is the user you log in to one your computer.&nbsp;&nbsp;Note
that if you are mounting as a normal user (not root) the mount point must be in
your home directory.<br><br>For example, if I wanted to mount my cloud to a
directory called 'cloud' in my home directory, and my username was bob, my fstab
would be <br><br><code class="inline-code">[baseurl]/dav/
/home/bob/cloud davfs user,noauto,uid=bob,file_mode=600,dir_mode=700 0
1</code><br><br>Now, create the mount point.<br><br><code
class="inline-code">mkdir /home/bob/cloud</code><br><br>and also create a
directory file to store your credentials<br><br><code class="inline-code">mkdir
/home/bob/.davfs2</code><br><br>Create a file called 'secrets'<br><br><code
class="inline-code">nano /home/bob/.davfs2/secrets</code><br><br>and add your
cloud login credentials<br><br><code><br><a
href="[baseurl]/dav">[baseurl]/dav</a>
&lt;username&gt; &lt;password&gt;<br></code><br><br>Where &lt;username&gt; and
&lt;password&gt; are the username and password <em>for your
hub</em>.<br><br>Don't let this file be writeable by anyone who doesn't need it
with<br><br><code class="inline-code">chmod 600
/home/bob/.davfs2/secrets</code><br><br>Finally, mount the drive.<br><br><code
class="inline-code">mount <a
href="[baseurl]/dav">[baseurl]/dav</a></code><br><br>
You can now find your cloud at /home/bob/cloud and use it as though it were part
of your local filesystem - even if the applications you are using have no dav
support themselves.<br><br><strong>Troubleshooting</strong><br><br>With some
webservers and certain configurations, you may find davfs2 creating files with 0
bytes file size where other clients work just fine.&nbsp;&nbsp;This is generally
caused by cache and locks.&nbsp;&nbsp;If you are affected by this issue, you
need to edit your davfs2 configuration.<br><br><code class="inline-code">nano
/etc/davfs2/davfs2.conf</code><br><br>Your distribution will provide a sample
configuration, and this file should already exist, however, most of it will be
commented out with a # at the beginning of the line.&nbsp;&nbsp;<br><br>First
step is to remove locks.<br><br>Edit the use_locks line so it reads <code
class="inline-code">use_locks 0</code>.<br><br>Unmount your file system, remount
your file system, and try copying over a file from the command
line.&nbsp;&nbsp;Note you should copy a new file, and not overwrite an old one
for this test.&nbsp;&nbsp;Leave it a minute or two then do <code
class="inline-code">ls -l -h</code> and check the file size of your new file is
still greater than 0 bytes.&nbsp;&nbsp;If it is, stop there, and do nothing
else.<br><br>If that still doesn't work, disable the cache.&nbsp;&nbsp;Note that
this has a performance impact so should only be done if disabling locks didn't
solve your problem.&nbsp;&nbsp;Edit the cache_size and set it to <code
class="inline-code">cache_size 0</code> and also set file_refresh to <code
class="inline-code">file_refresh 0</code>.&nbsp;&nbsp;Unmount your filesystem,
remount your file system, and test it again.<br><br>If it <em>still</em> doesn't
work, there is one more thing you can try.&nbsp;&nbsp;(This one is caused by a
bug in older versions of dav2fs itself, so updating to a new version may also
help).&nbsp;&nbsp;Enable weak etag dropping by setting <code
class="inline-code">drop_weak_etags 1</code>.&nbsp;&nbsp;Unmount and remount
your filesystem to apply the changes.


<h4>Dolphin</h4>
Visit webdavs://example.com/dav where "example.com" is the URL of your hub.

When prompted for a username and password, enter your channel name (the first part of your webbie - no @ or domain name) and password for your normal account.

Note, if you are already logged in to the web interface via Konqueror, you will not be prompted for further authentication.


<h4>Konqueror</h4>

Simply visit webdavs://example.com/cloud after logging in to your hub, where "example.com" is the URL of your hub.

No further authentication is required if you are logged in to your hub in the normal manner.  

Additionally, if one has authenticated at a different hub during their normal browser session, your identity will be passed to the cloud for these hubs too - meaning you can access any private files on any server, as long as you have permissions to see them, as long as you have visited that site earlier in your session.

This functionality is normally restricted to the web interface, and is not available to any desktop software other than KDE.

<h4>Nautilus</h4>

1. Open a File browsing window (that's Nautilus)<br>2. Select File &gt; Connect to server from the menu<br>3. Type davs://&lt;domain_name&gt;/dav/&lt;your_channelname&gt; and click Connect<br>4. You will be prompted for your channel name (same as above) and password<br>5. Your personal DAV directory will be shown in the window

<h4>Nemo</h4>

For (file browser) Nemo 1.8.2 under Linux Mint 15, Cinnamon 1.8.8. Nemo ist the standard file browser there.<br><br>1st way<br>type "davs://&lt;domain_name&gt;/dav/&lt;your_channelname&gt;" in the address bar.<br><br>2nd way<br>Menu &gt; file &gt; connect to server<br>Fill the dialog<br>- Server: hubzilla_domain_name<br>- Type: Secure WebDAV (https)<br>- Folder: /dav<br>- Username: yourchannelname<br>- Password: yourpassword<br><br>Once open you can set a bookmark.
		


<strong>Server Notes</strong><br><br>Note: There have been reported issues with clients that
use "chunked transfer encoding", which includes Apple iOS services, and also the
"AnyClient" and "CyberDuck" tools. These work fine for downloads, but uploads
often end up with files of zero size. This is caused by an incorrect
implemention of chunked encoding in some current FCGI (fast-cgi)
implementations. Apache running with PHP as a module does not have these issues,
but when running under FCGI you may need to use alternative clients or use the
web uploader. At the time of this writing the issue has been open and no updates
provided for at least a year. If you encounter zero size files with other
clients, please check the client notes; as there are occasional configuration
issues which can also produce these symptoms.	


<h1 id="remove-channel">Remove Channel or Account</h1>

<br><br><strong>Remove Channel</strong><br><br>Go to the bottom of your channel
settings page or visit the URL:<br><br>&nbsp;&nbsp;&nbsp;&nbsp;<a
href="[baseurl]/removeme">[baseurl]/removeme</a>
<br><br>You will need to confirm your password and the channel you are currently
logged into will be removed. <br><br>This is irreversible.<br><br>If you have
identity clones on other hubs this only removes&nbsp;&nbsp;by default the
channel instance which exists on this hub.<br><br><strong>Remove
Account</strong><br><br>Go to the bottom of your account settings page or visit
the URL:<br><br>&nbsp;&nbsp;&nbsp;&nbsp;<a
href="[baseurl]/removeaccount">[baseurl]/removeaccount
</a><br>&nbsp;&nbsp;&nbsp;&nbsp;<br>You will need to confirm your password and
the account you are currently logged into will be removed. <br><br>This is
irreversible.<br><br>All your channels will be deleted. If you have identity
clones on other hubs this only removes by default the channels instances which
exists on this hub.