Mastodon

Mastodon — One-Click Install

Your self-hosted, globally interconnected microblogging community

Why install Mastodon with Web.Casa?

One-Click Deploy

No manual Docker Compose needed. Web.Casa configures and starts everything.

Auto HTTPS

Caddy auto-provisions SSL certificates. Reverse proxy works out of the box.

Unified Management

Monitoring, backups, updates, logs — manage all apps from one panel.

How to Install

Install Web.Casa first, then one-click install this app from the App Store.

App Info

Version
4.5.7
Author
Mastodon
Default Port
8210

Installation Notice

  • Mastodon is a heavy app, and may take a bit longer to fully start up.
  • Must be on Tipi Version 1.4.0 for the expose app to work!

Local Domain Varibale

  • The local domain variable ca be the same as the exposed domain (Ex: social.example.com). But you could have the exposed domain as social.example.com and the username url as example.com.

Initial User Setup

  1. SSH into your Tipi Server
  2. Fill in your credentials (some_username,[email protected], some_very_good_password), then run the command:
    sudo docker exec -it -w /app/www mastodon bin/tootctl accounts create some_username --email [email protected] --confirmed --role Owner 
    

Mastodon is a free, open-source social network server based on ActivityPub where users can follow friends and discover new ones. On Mastodon, users can publish anything they want: links, pictures, text, video. All Mastodon servers are interoperable as a federated network (users on one server can seamlessly communicate with users from another one, including non-Mastodon software that implements ActivityPub!)

Click below to learn more in a video:

Screenshot Screenshot

Features

No vendor lock-in: Fully interoperable with any conforming platform

It doesn't have to be Mastodon; whatever implements ActivityPub is part of the social network! Learn more

Real-time, chronological timeline updates

Updates of people you're following appear in real-time in the UI via WebSockets. There's a firehose view as well!

Media attachments like images and short videos

Upload and view images and WebM/MP4 videos attached to the updates. Videos with no audio track are treated like GIFs; normal videos loop continuously!

Safety and moderation tools

Mastodon includes private posts, locked accounts, phrase filtering, muting, blocking and all sorts of other features, along with a reporting and moderation system. Learn more

OAuth2 and a straightforward REST API

Mastodon acts as an OAuth2 provider, so 3rd party apps can use the REST and Streaming APIs. This results in a rich app ecosystem with a lot of choices!

FAQ

Can I install Mastodon on Web.Casa?

Yes, Mastodon is available in the Web.Casa App Store. You can install it with one click from the Web.Casa panel — no need to manually write Docker Compose files or configure reverse proxies.

How do I install Mastodon on Web.Casa?

First install Web.Casa with curl -fsSL https://get.web.casa | bash, then search for "Mastodon" in the App Store and click install. Web.Casa automatically configures the Docker container, assigns ports, and sets up a Caddy reverse proxy.

What is the default port for Mastodon on Web.Casa?

The default port for Mastodon on Web.Casa is 8210. You can bind it to a custom domain through Web.Casa's Caddy reverse proxy, which automatically provisions HTTPS certificates.

Does Mastodon get automatic HTTPS after installation?

Yes. Web.Casa is built on Caddy, so after installing the app, simply bind a domain and Caddy will automatically provision and renew SSL certificates via Let's Encrypt — no manual configuration needed.

How do I back up Mastodon data?

Web.Casa has a built-in backup plugin that supports automatic backups of Mastodon data to local storage, S3, WebDAV, or SFTP. You can configure scheduled snapshots and retention policies to keep your data safe.