GoToSocial is a self-hosted ActivityPub social network server, that this playbook can install, powered by the mother-of-all-self-hosting/ansible-role-gotosocial Ansible role.
This service requires the following other services:
- a Postgres database
- a Traefik reverse-proxy server
- (optional) the exim-relay mailer
To enable this service, add the following configuration to your vars.yml file and re-run the installation process:
########################################################################
# #
# gotosocial #
# #
########################################################################
gotosocial_enabled: true
# Hostname that this server will be reachable at.
# DO NOT change this after your server has already run once, or you will break things!
# Examples: ["gts.example.org","some.server.com"]
gotosocial_hostname: 'social.example.org'
########################################################################
# #
# /gotosocial #
# #
########################################################################The account domain is the second part of a user handle in the Fediverse. If your handle is @[email protected], example.org is your account domain. By default GoToSocial will use gotosocial_hostname that you provide as account domain e.g. social.example.org. You might want to change this by setting gotosocial_account_domain if you want the domain on accounts to be example.org because it looks better or is just shorter/easier to remember.
Warning DO NOT change this change this after your server has already run once, or you will break things!
If you decide to use this read the appropriate section of the documentation as you will have to do some additional work on the base domain.
gotosocial_account_domain: "example.org"You can use the following variables in your vars.yml to enable e-mail notifications.
# Check out https://docs.gotosocial.org/en/latest/configuration/smtp/ for a configuration reference
gotosocial_smtp_host: 'smtp.example.org'
gotosocial_smtp_username: [email protected]
gotosocial_smtp_password: yourpassword
gotosocial_smtp_from: [email protected]After installing, you can:
-
create an administrator user account with a command like this:
just run-tags gotosocial-add-admin --extra-vars=username=USERNAME_HERE --extra-vars=password=PASSWORD_HERE --extra-vars=email=EMAIL_HERE -
create a regular (non-administrator) user account with a command like this:
just run-tags gotosocial-add-user --extra-vars=username=USERNAME_HERE --extra-vars=password=PASSWORD_HERE --extra-vars=email=EMAIL_HERE
Then, you should be able to visit the URL specified in gotosocial_hostname and see your instance.
To customize your instance, go to the /admin page.
Use the GtS CLI Tool to do admin & maintenance tasks. E.g. use
docker exec -it mash-gotosocial /gotosocial/gotosocial admin account demote --username USERNAME_HEREto demote a user from admin to normal user.
Refer to the great official documentation for more information on GoToSocial.
The following assumes you want to migrate from serverA to serverB (managed by mash) but you just cave to adjust the copy commands if you are on the same server.
Stop the initial instance on serverA
serverA$ systemctl stop gotosocialDump the database (depending on your existing setup you might have to adjust this)
serverA$ pg_dump gotosocial > latest.sql
Copy the files to the new server
serverA$ rsync -av -e "ssh" latest.sql root@serverB:/mash/gotosocial/
serverA$ rsync -av -e "ssh" data/* root@serverB:/mash/gotosocial/data/Install (but don't start) the service and database on the server.
yourPC$ just run-tags install-all
yourPC$ just run-tags import-postgres --extra-vars=server_path_postgres_dump=/mash/gotosocial/latest.sql --extra-vars=postgres_default_import_database=mash-gotosocialStart the services on the new server
yourPC$ just run-tags startDone 🥳