Mastodon

*[Update: July 10, 2017]

Attention

*Added on April 24, 2017 The startup script was updated at 18:00 on April 24, 2017. Please refer to the following article if you used the startup script to create a Mastodon instance prior to 18:00 on April 24, 2017: Notice for the updating of the startup script Mastodon & Work request for instances created using the old script .

Attention

*Added on May 1, 2017 The startup script was updated at 12:00 on May 1, 2017. Please refer to the following article if you used the startup script to create a Mastodon instance prior to 12:00 on May 1, 2017: Notice for the updating of the startup script Mastodon & Work request for instances created using the script prior to 12:00 on May 1, 2017.

Attention

*Added on June 1, 2017 The startup script was updated at 11:45 on June 1, 2017. Please refer to the following article if you used the startup script to create a Mastodon instance prior to 11:45 on June 1, 2017: Notice for the updating of the startup script Mastodon & Work request for instances created using the script prior to 11:45 on June 1, 2017.

Attention

*Added on July 10, 2017 The startup script was updated at 12:00 on July 10, 2017. Please refer to the following article if you used the startup script to create a Mastodon instance prior to 12:00 on July 10, 2017: Notice for the updating of the startup script Mastodon & Work request for instances created using the script prior to 12:00 on July 10, 2017.

This page explains the startup script “Mastodon” for SAKURA Cloud.

1. Overview

This startup script is for easy setup of an instance (server) of the decentralized social network Mastodon that can be used to post short messages like Twitter.

Item Overview/version
Supported OS CentOS7.x
DNS zone administered using SAKURA Cloud DNS Enter at the time of installation (required).
API key Select from list (advance creation required).

*Executing this script adds a record to the Zone APEX that is administered using the SAKURA Cloud DNS. When a record is registered to the target zone, the script stops and setup is interrupted. Please prepare a dedicated domain without any registered records.

*Executing this script specifies the following 3 lines for the zone resource records administered using SAKURA Cloud DNS.

*Subdomains (example: mstdn.example.com) are not supported.

*The latest release version at the time of startup script execution is installed. Our company assumes absolutely no responsibility for bugs or problems in Mastodon.

2. Preparation and script processing

Work by the customer

Item Overview
Add DNS zone. Please add a Mastodon zone to SAKURA Cloud DNS.
Create API key. Create the SAKURA Cloud API key and write down the name of the API key.
Execute the startup script. Select the startup script “mastodon” when creating a server.

Internal processing for startup script

Item Overview
Install Mastodon. Install Mastodon or the application used by Mastodon (Docker is not used).
Specify settings for Firewalld. Release HTTPS (443/TCP) or SMTP (25/TCP) for use in Mastodon
Specify settings for Let’s Encrypt. Perform setup and specify automatic update settings for the free SSL server certificate “Let’s Encrypt.”
Specify settings for Postfix. Perform setup for the email server “Postfix.” Can only be used to send messages to the registered email address of Mastodon users (security measures are implemented so that the email server cannot be used a foothold by external parties).
Reverse lookup settings Set the PTR record corresponding to the DNS zone name used by Mastodon.

3. Usage procedures

Use the following procedures to create the “Mastodon” startup script and to specify settings.

Add DNS zone.

Click [DNS] on the left menu of the SAKURA Cloud control panel, and then click [Add] at the top right.

Enter the zone name and then click [Create].

The DNS server FQDN is displayed on the details screen of the added zone. Operate the settings screen for the registrar where the domain was aquired. Enter the FQDN of the displayed DNS server and change domain settings. For procedures to change the domain settings, please refer to the help page of each registrar.

Create API key.

Click [Settings] at the top right of the SAKURA Cloud control panel.

Click [API key] and then click [Add].

Enter the name and then click [Add].

The pop-up shown below is displayed. It is necessary to select the API key from the list when executing the startup script. Therefore, please remember the name of the API key that you created.

Server creation procedures (1)

Click [Server] in the menu on the left, and then click [Add] at the top right.

Click [Server] in the menu on the left, and then click [Add] at the top right.

When creating a server, remove the check from the checkbox for simple mode.

For the archive, select “CentOS7.x.”

Server creation procedures (2): Specify the startup script.

Startup script

Click the [shell] radio button.

Startup script being put

Select [mastodon].

DNS zone administered using SAKURA Cloud DNS

Enter the zone name that you registered at the previous page “Add DNS zone.”

API key

Select the API key name that you created at the previous page “Create API key.”

Click [Create] at the bottom right in order to create the server. Time is required to create the server and execute the startup script. Please wait a short while before proceeding to the next page.

Log in to web.

Use the web browser to connect to https://<DNS zone name>/. Setup is complete once the following screen is displayed.

Enter the user name, email address, and password, and then click [Participate].

The user authentication email is in the format “From:mastodon@{domain}.” There is the possibility that the user authentication email may be sent to the junk email folder. Therefore, we recommend performing reverse lookup settings for the IP address.

About script details

Please refer to Here.