Go to file
2025-01-10 17:24:08 -06:00
release initial 2025-01-09 11:39:54 -06:00
.drone.yml update drone-ci 2025-01-09 19:31:32 -06:00
.env.sample add registration apporval env 2025-01-10 16:17:18 -06:00
.gitignore initial 2025-01-09 11:39:54 -06:00
abra.sh add an entrypoint to replace usage of config file 2025-01-10 14:57:20 -06:00
compose.oidc.yml remove secret file env 2025-01-10 17:03:35 -06:00
compose.smtp.yml remove secret file env 2025-01-10 17:03:35 -06:00
compose.yml fix mistyped entrypoint name in compose file 2025-01-10 15:03:58 -06:00
entrypoint.sh.tmpl modify entrypoint file to work using sh instead of bash, rtfm 2025-01-10 17:04:57 -06:00
README.md update readme 2025-01-10 17:24:08 -06:00

gotosocial

Light ActivityPub server compatible with Mastodon's client API, designed for small to medium sized deployments.

  • Category: Apps
  • Status: 3
  • Image: gotosocial, 4, upstream
  • Healthcheck: Yes
  • Backups: No
  • Email: 3
  • Tests: No
  • SSO: 3 (OIDC)

Quick start

  • abra app new gotosocial
  • abra app config <app-name>
  • abra app deploy <app-name>

Note: The initial startup commonly takes longer than the allotted time for setup, please give it some time to start up (probably 2-3 minutes).

Add your first account

  • abra app run <app-name> app ./gotosocial admin account create --username <user-name> --email <user-email> --password '<a-secure-password>'
  • Make them an admin: abra app run <app-name> app ./gotosocial admin account promote --username <user-name>

Federation mode

You will want to consider either using an allowlist or a blacklist for federation, this is configurable using GTS_INSTANCE_FEDERATION_MODE which is set to allowlist by default meaning you will have to explicitly allow federation with other instances via the settings panel https://your-domain.com/settings.

SMTP

Add your SMTP password Note: Only STARTTLS is supported currently

  • abra app secret insert <app-name> smtp_password v1 <oidc-secret>

OIDC

Add your OIDC secret

  • abra app secret insert <app-name> oidc_secret v1 <oidc-secret>

Further reading & commands

Please refer to https://docs.gotosocial.org some of the commands run will require redeploying the app.

If you need to run any particular command make sure to append ./ to the command gotosocial as it is not in the contianer's PATH.