Skip to content
Mastodon is a free, open-source social network for YunoHost
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

Mastodon for YunoHost

Integration level
Install Mastodon with YunoHost

Lire ce readme en français.

This package allow you to install Mastodon quickly and simply on a YunoHost server.
If you don't have YunoHost, please see here to know how to install and enjoy it.


Mastodon is a free, open-source social network. A decentralized alternative to commercial platforms, it avoids the risks of a single company monopolizing your communication. Pick a server that you trust — whichever you choose, you can interact with everyone else. Anyone can run their own Mastodon instance and participate in the social network seamlessly.

Shipped version: 3.0.1

Important points to read before installing

  1. Mastodon require a dedicated root domain, eg. mastodon.domain.tld
  2. The user choosen during the installation is automatically created in Mastodon with admin rights
  3. At the end of the installation a mail is sent to the user with the automatically generated password
  4. It seems important to close the inscriptions for your Mastodon, so that it remains a private body. We invite you to block remote malicious instances from the administration interface. You can also add text on your home page.


Source code



Using screen in case of disconnect

$ sudo apt-get install screen
$ screen
$ sudo yunohost app install

Recover after disconnect:

$ screen -d
$ screen -r


Using screen highly recommended

$ sudo yunohost app upgrade mastodon -u --debug


YunoHost specific features

Supported architectures

  • x86-64b - Build Status
  • ARMv8-A - Build Status
  • Jessie x86-64b - Build Status


Developers info

Please do your pull request to the testing branch.

To try the testing branch, please proceed like that.

sudo yunohost app install --debug
sudo yunohost app upgrade mastodon -u --debug
You can’t perform that action at this time.