~~NOTOC~~
====== FAQ / Friendica ======
{{entry>FAQ/Friendica;-}}
{{entry>FuA/Friendica;-}}

Common questions for Friendica:

===== User FAQ =====

<accordion>
<panel title="Are there any clients for Friendica I can use?">Friendica is using a [[docs:api-twitter|Twitter]]/[[docs:api-gnu-social|GNU Social]] compatible API as well as a [[docs:api-mastodon|Mastodon]] compatible API, which means you can use any Mastodon/Twitter/GNU Social client for your platform as long as you can change the API path in its settings. Here is a list of known working clients:

=== Android ===

  * [[http://andstatus.org|AndStatus]] ([[https://f-droid.org/repository/browse/?fdid=org.andstatus.app|F-Droid]], [[https://play.google.com/store/apps/details?id=org.andstatus.app|Google Play]])
  * [[https://github.com/AnywhereSoftware/B4X-Pleroma|B4X for Pleroma & Mastodon]]
  * [[https://play.google.com/store/apps/details?id=com.fediverse.app|Fedi]]
  * [[https://fedilab.app|Fedilab]] ([[https://f-droid.org/app/fr.gouv.etalab.mastodon|F-Droid]], [[https://play.google.com/store/apps/details?id=app.fedilab.android|Google Play]])
  * [[https://git.friendi.ca/lubuwest/Friendiqa|Friendiqa]] ([[https://git.friendi.ca/lubuwest/Friendiqa#install|F-Droid]], [[https://play.google.com/store/apps/details?id=org.qtproject.friendiqa|Google Play]])
  * [[https://git.sr.ht/~captainepoch/husky|Husky]] ([[https://f-droid.org/repository/browse/?fdid=su.xash.husky|F-Droid]], [[https://play.google.com/store/apps/details?id=su.xash.husky|Google Play]])
  * [[https://github.com/mastodon/mastodon-android|Mastodon for Android]] (F-Droid: Pending, [[https://play.google.com/store/apps/details?id=org.joinmastodon.android|Google-Play]])
  * [[https://github.com/tateisu/SubwayTooter|Subway Tooter]]
  * [[https://tooot.app/|Tooot]]
  * [[https://tusky.app|Tusky]] ([[https://f-droid.org/repository/browse/?fdid=com.keylesspalace.tusky|F-Droid]], [[https://play.google.com/store/apps/details?id=com.keylesspalace.tusky|Google Play]])
  * [[https://github.com/TwidereProject/Twidere-Android|Twidere]] ([[https://f-droid.org/repository/browse/?fdid=org.mariotaku.twidere|F-Droid]], [[https://play.google.com/store/apps/details?id=com.twidere.twiderex|Google Play]])
  * [[https://github.com/TwidereProject/TwidereX-Android|TwidereX]] ([[https://f-droid.org/en/packages/com.twidere.twiderex/|F-Droid]], [[https://play.google.com/store/apps/details?id=com.twidere.twiderex|Google Play]])
  * [[https://github.com/accelforce/Yuito|Yuito]] ([[https://play.google.com/store/apps/details?id=net.accelf.yuito|Google Play]])

=== SailfishOS ===

  * [[https://openrepos.net/content/fabrixxm/friendly|Friendly]], last update: 2018

=== iOS ===

  * [[https://github.com/AnywhereSoftware/B4X-Pleroma|B4X for Pleroma & Mastodon]] ([[https://apps.apple.com/app/b4x-pleroma/id1538396871|AppStore]])
  * [[https://fediapp.com|Fedi]] ([[https://apps.apple.com/de/app/fedi-for-pleroma-and-mastodon/id1478806281|AppStore]])
  * [[https://joinmastodon.org/apps|Mastodon for iPhone and iPad]] ([[https://apps.apple.com/us/app/mastodon-for-iphone/id1571998974|AppStore]])
  * [[https://www.stella-app.net/|Stella*]] ([[https://apps.apple.com/us/app/stella-for-mastodon-twitter/id921372048|AppStore]])
  * [[https://github.com/tooot-app|Tooot]] ([[https://apps.apple.com/app/id1549772269|AppStore]], Data collection (not linked to identity)
  * [[https://mastodon.cloud/@tootleapp|Tootle]] ([[https://apps.apple.com/de/app/tootle-for-mastodon/id1236013466|AppStore]]), last update: 2020

=== Linux ===

  * [[https://choqok.kde.org|Choqok]]
  * [[https://whalebird.social|Whalebird]]
  * [[https://ja.mstdn.wiki/TheDesk|TheDesk]]
  * [[https://toot.readthedocs.io/en/latest/|Toot]]
  * [[https://github.com/bleakgrey/tootle|Tootle]]

=== macOS ===

  * [[https://mastonaut.app/|Mastonaut]] ([[https://apps.apple.com/us/app/mastonaut/id1450757574|AppStore]]), closed source
  * [[https://whalebird.social/en/desktop/contents|Whalebird]] ([[https://apps.apple.com/de/app/whalebird/id1378283354|AppStore]], [[https://github.com/h3poteto/whalebird-desktop|GitHub]])

=== Windows ===

  * [[https://whalebird.social/en/desktop/contents|Whalebird]] ([[https://whalebird.social/en/desktop/contents/downloads#windows|Website Download]], [[https://github.com/h3poteto/whalebird-desktop|GitHub]])

=== Web Frontend ===

  * [[https://www.halcyon.social/|Halcyon]]
  * [[https://github.com/nolanlawson/pinafore|Pinafore]]
</panel>

<panel title="Why do I get warnings about SSL certificates?">SSL (Secure Socket Layer) is a technology to encrypt data transfer between computers. Sometimes your browser warns you about a missing or invalid certificate. These warnings can have three reasons:

  - The server you are connected to doesn't offer SSL encryption.
  - The server has a self-signed certificate (not recommended).
  - The certificate is expired.

We recommend to talk to the admin(s) of the affected friendica server. (Admins, please see the respective [[docs:ssl|section of the admin manual]].)</panel>

<panel title="How can I upload images, files, links, videos and sound files to posts?">You can upload images from your computer using the [editor](help/Text_editor). An overview of all uploaded images is listed at *example.com/photos/profilename*. On that page, you can also upload images directly and choose if your contacts will receive a message about this upload.

Generally, you can attach any kind of file to a post. This is possible by using the "paper-clip"-symbol in the editor. These files will be linked to your post and can be downloaded by your contacts. But it's not possible to get a preview for these items. Because of this, this upload method is only recommended for office or zipped files. If you want to share content from Dropbox, Nextcloud or any other [[http://en.wikipedia.org/wiki/Comparison_of_file_hosting_services|filehoster]]), use the "link"-button (chain-symbol).

When you're adding URLs of other webpages with the "link"-button, Friendica tries to create a small preview. If this doesn't work, try to add the link by typing: <code>[url=http://example.com]self-chosen name[/url]</code>.

You can also add video and audio files to posts. However, instead of a direct upload you have to use one of the following methods:

  - Add the video or audio link of a hoster (Youtube, Vimeo, Soundcloud and anyone else with oembed/opengraph-support). Videos will be shown with a preview image you can click on to start. SoundCloud directly inserts a player to your post. 
  - If you have your own server, you can upload multimedia files via FTP and insert the URL.

Friendica uses HTML5 for embedding content. Therefore, the supported files are dependent on your browser and operating system. Some supported file types are WebM, MP4, MP3 and OGG. See Wikipedia for more of them [[https://en.wikipedia.org/wiki/HTML5_video|video]], [[http://en.wikipedia.org/wiki/HTML5_audio|audio]].</panel>

<panel title="How can I view Friendica in a certain language?">You can do this by adding the `lang` parameter to the url in your url bar. The data in the parameter is a [[https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes|ISO 639-1]] code. A question mark is required for the separation between url and parameters.

For example if you want to see https://example.com/profile/example in German you have to add ''?lang=de'' to the URL: https://example.com/profile/example?lang=de. When a certain language is forced, the language remains until session is closed. </panel>

<panel title="What is the difference between blocked|ignored|archived|hidden contacts?">We prevent direct communication with **blocked contacts**. They are not included in delivery, and their own posts to you are not imported. However their conversations with your friends will still be visible in your stream. If you remove a contact completely, they can send you another friend request. Blocked contacts cannot do this. They cannot communicate with you directly, only through friends.

**Ignored contacts** are included in delivery - they will receive your posts and private messages. However we do not import their posts or private messages to you. Like blocking, you will still see this person's comments to posts made by your friends. An addon called "blockem" can be installed to collapse/hide all posts from a particular person in your stream if you desire complete blocking of an individual, including his/her conversations with your other friends.

An **archived contact** means that communication is not possible and will not be attempted. (Perhaps the person moved to a new site and removed the old profile.) However unlike blocking, existing posts this person made before being archived will be visible in your stream.

A **hidden contact** will not be displayed in any "friend list" (except to you). However a hidden contact will appear normally in conversations and this may expose his/her hidden status to anybody who can see the conversation.</panel>

<panel title="What happens when an account is removed?">If you remove your account, it will be scheduled for permanent deletion in *seven days*. As soon as you activate the deletion process you won't be able to login any more. Only the administrator of your node can halt this process prior to permanent deletion.

After the elapsed time of seven days, all your posts, messages, photos, and personal information stored on your node will be deleted. Your node will also issue removal requests to all your contacts; this will also remove your profile from the global directory if you are listed. Your username cannot be reissued for future sign-ups for security reasons.</panel>

<panel title="Can I follow a hashtag?">Yes. Simply add the hash tag to your saved searches. The posts will appear on your network page. For technical reasons, your answers to such posts won't appear on the "personal" tab in the network page and the whole thread isn't accessible via the API.</panel>

<panel title="How to create a RSS feed of the stream?">If you want to share your public page via rss you can use one of the following links:

The RSS feed of your posts is available at

<code>example.com//feed/[nickname]/posts</code>

For example the feed of the Friendica Support forum can be found at https://forum.friendi.ca/feed/helpers/posts.

The RSS feed of the conversations at your site, including your postings and the comments is located at

<code>example.com/feed/profilename/comments</code></panel>

<panel title="Where I can find help?">If you have problems with your Friendica page, you can ask the community at the [[https://forum.friendi.ca/profile/helpers|Friendica Support Group]]. If you can't use your default profile you can use an account at a public site [[https://dir.friendica.social/servers|list]].

In case you do not want to set up another account on Friendica, you can also use one of the following channels to reach out for help:

  * [[https://forum.friendi.ca/~helpers|Friendica Support Forum]]
  * [[http://mailman.friendi.ca/mailman/listinfo/support-friendi.ca|Mailing List Archive]] you can subscribe to the list by sending an email to ''support-request(at)friendi.ca?subject=subscribe''
  * Community chat (the IRC, Matrix and XMPP rooms are bridged). The chat is logged on Matrix and IRC an archive of the chat can be found at https://gnusociarg.nsupdate.info/2021/%23friendica/ or using the Matrix web client https://view.matrix.org/room/!BNMPbgPACTjCnwCtJb:grin.hu/
    * XMPP/Jabber MUC: ''support(at)forum.friendi.ca''
    * IRC: #friendica at ''irc.libera.chat''
    * Matrix: #friendi.ca or #friendica-en at ''matrix.org''
</panel>
</accordion>

===== Admin FAQ =====

<accordion>
<panel title="How can I check if my mail setup works for Friendica?">
Friendica uses the php ''mail()'' command which uses the servers abilities to send emails. Alternatively you can use an external SMTP server with the [[https://git.friendi.ca/friendica/friendica-addons/src/branch/develop/phpmailer|phpmailer]] addon.

If you encounter problems with the ''mail()'' command of php, you could try this guide to [[https://mediatemple.net/community/products/grid/360016044211/troubleshooting-common-issues-with-php-mail|troubleshoot common issues with PHP Mail]].

If your servers mail setup does not work, you can use the [[https://git.friendi.ca/friendica/friendica-addons/src/branch/develop/phpmailer|PHPMailer]] addon to use an external SMTP server.
</panel>
<panel title="Can I configure multiple domains with the same code instance?">No, this function is no longer supported as of Friendica 3.3 onwards.</panel>
<panel title="Where can I find the source code of friendica, addons and themes?">You can find the main repository at [[https://github.com/friendica/friendica|github.com/friendica/friendica]] or [[https://git.friendi.ca/friendica/friendica|git.friendi.ca/friendica/friendica]]. There you will always find the current stable version of friendica.

Addons are listed at [[https://github.com/friendica/friendica-addons|github.com/friendica/friendica-addons]] or [[https://git.friendi.ca/friendica/friendica-addons|git.friendi.ca/friendica/friendica-addons]].

Themes are available in the ''view/themes'' directory of the core repository. If you have created your own theme and want to promote it, please feel free to contact us! Older themes that are no longer supported can be found in [[https://git.friendi.ca/friendica/deprecated-themes|a separate repository]].
</panel>
<panel title="I've changed my email address now the admin panel is gone?">Have a look into your ''config/local.config.php'' and fix your email address there.</panel>
<panel title="Can there be more then one admin for a node?">Yes. You just have to list more then one email address in the ''config/local.config.php'' file. The listed emails need to be separated by a comma.</panel>
<panel title="The Database structure seems not to be updated. What can I do?">Please have a look at the Admin panel under [DB updates](/admin/dbsync/) and follow the link to *check database structure*. This will start a background process to check if the structure is up to the current definition.

You can manually execute the structure update from the CLI in the base directory of your Friendica installation by running the following command:
<code>

  bin/console dbstructure update

</code>

if there occur any errors, please contact the [support forum]([[https://forum.friendi.ca/profile/helpers|https://forum.friendi.ca/profile/helpers]]).
</panel>
<panel title="Can I customize the landing page of my Friendica server?">Yes you can! Create a file called ''home.html'' in the root directory of your Friendica installation. To add some styling to the contents of that page, you can use CSS which you can place in the ''home.css'' file.</panel>
</accordion>