{"id":15690219,"url":"https://github.com/jakejarvis/mastodon-installer","last_synced_at":"2025-05-07T23:33:03.026Z","repository":{"id":146831907,"uuid":"568460668","full_name":"jakejarvis/mastodon-installer","owner":"jakejarvis","description":"🦣 Mastodon auto-installer for self-hosted instances","archived":false,"fork":false,"pushed_at":"2022-12-11T14:56:47.000Z","size":32,"stargazers_count":13,"open_issues_count":4,"forks_count":2,"subscribers_count":6,"default_branch":"main","last_synced_at":"2025-03-04T12:43:53.187Z","etag":null,"topics":["bash","bash-script","fediverse","mastodon","self-hosted","ubuntu"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jakejarvis.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2022-11-20T15:53:10.000Z","updated_at":"2025-01-23T16:32:38.000Z","dependencies_parsed_at":"2023-09-21T20:13:19.090Z","dependency_job_id":null,"html_url":"https://github.com/jakejarvis/mastodon-installer","commit_stats":{"total_commits":12,"total_committers":1,"mean_commits":12.0,"dds":0.0,"last_synced_commit":"aa46cabb7cc29abfa26437b0fee048e616550528"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jakejarvis%2Fmastodon-installer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jakejarvis%2Fmastodon-installer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jakejarvis%2Fmastodon-installer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jakejarvis%2Fmastodon-installer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jakejarvis","download_url":"https://codeload.github.com/jakejarvis/mastodon-installer/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243042907,"owners_count":20226720,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bash","bash-script","fediverse","mastodon","self-hosted","ubuntu"],"created_at":"2024-10-03T18:08:21.198Z","updated_at":"2025-03-11T13:31:57.557Z","avatar_url":"https://github.com/jakejarvis.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🦣 Mastodon installer (unofficial)\n\n\u003e ⚠️ This is ***beyond experimental*** and may need some manual intervention from you. [Let me know](https://github.com/jakejarvis/mastodon-installer/issues) about any problems you run into!\n\n![Escape the Space Karen](https://user-images.githubusercontent.com/1703673/202923190-95424152-3eb5-45ed-86e7-0ae0c89f917c.JPG)\n\nBe your own [hall monitor](https://twitter.com/elonmusk/status/1594757734267764774) and host your own [Mastodon](https://joinmastodon.org/) server on the fediverse!\n\n## Requirements\n\n- Ubuntu 20.04 LTS (support for 22.04 is in the works!)\n- A server or [VPS](https://github.com/joedicastro/vps-comparison) (in the cloud, on your Raspberry Pi, anywhere!) with ***at least*** 2 GB of memory\n- A domain name (or subdomain) already pointing to this server's public IP address\n\n## Usage\n\n### Running the script\n\nIf you trust me (which you shouldn't, _please_ don't trust random people on the internet!) this will download and run the installer automatically:\n\n```sh\n# with curl\ncurl -fsSL https://github.com/jakejarvis/mastodon-installer/raw/HEAD/install.sh | bash\n\n# alternatively, with wget\nwget -q https://github.com/jakejarvis/mastodon-installer/raw/HEAD/install.sh -O- | bash\n```\n\nOr, clone this repository and make sure the installer is executable before running:\n\n```sh\ngit clone https://github.com/jakejarvis/mastodon-installer.git \u0026\u0026 cd mastodon-installer\nchmod +x install.sh\n./install.sh\n```\n\n### What's next?\n\n- [Close new registrations](https://discourse.joinmastodon.org/t/how-to-close-registrations/2629/2) if you intend for this to be a single-user server.\n- Review the many [config options](https://docs.joinmastodon.org/admin/config/) located in `/home/mastodon/live/.env.production`\n- Harden your server's security using:\n  - [UFW](https://www.linode.com/docs/guides/configure-firewall-with-ufw/) or [iptables](https://docs.joinmastodon.org/admin/prerequisites/#install-a-firewall-and-only-allow-ssh-http-and-https-ports)\n  - [Fail2ban](https://docs.joinmastodon.org/admin/prerequisites/#install-fail2ban-so-it-blocks-repeated-login-attempts) if you _really_ need to keep SSH open to the world.\n- [Offload media files to Amazon S3](https://docs.joinmastodon.org/admin/optional/object-storage-proxy/). They **will** eat a ton of disk space, even on a single-user server! You can also use an S3-compatible cloud storage product, such as:\n  - [DigitalOcean Spaces](https://www.digitalocean.com/products/spaces)\n  - [Linode Object Storage](https://www.linode.com/products/object-storage/)\n  - [Wasabi](https://wasabi.com/cloud-storage-pricing/)\n- Configure an email provider:\n  - [Mailgun](https://www.mailgun.com/products/send/smtp/free-smtp-service/) and [SendGrid](https://sendgrid.com/free/) have a free tier\n  - ...but any regular SMTP server will work.\n- Tune [Sidekiq \u0026 Puma](https://docs.joinmastodon.org/admin/scaling/#concurrency) for performance and consider using [pgBouncer](https://docs.joinmastodon.org/admin/scaling/#pgbouncer).\n  - [Official scaling docs](https://docs.joinmastodon.org/admin/scaling/)\n  - [Scaling Mastodon: The Compendium](https://hazelweakly.me/blog/scaling-mastodon/)\n  - [Scaling up a Mastodon server to 128K active users](https://gist.github.com/Gargron/aa9341a49dc91d5a721019d9e0c9fd11)\n  - [Scaling Mastodon _down_](https://gist.github.com/nolanlawson/fc027de03a7cc0b674dcdc655eb5f2cb)\n  - Advanced: [Installing \u0026 Monitoring Mastodon](https://ipng.ch/s/articles/2022/11/20/mastodon-1.html) ([Part 2](https://ipng.ch/s/articles/2022/11/24/mastodon-2.html), [Part 3](https://ipng.ch/s/articles/2022/11/27/mastodon-3.html))\n\n## Software installed\n\n- Mastodon, of course\n- Nginx\n- PostgreSQL\n- Redis\n- Node + Yarn\n- Ruby\n- Certbot\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjakejarvis%2Fmastodon-installer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjakejarvis%2Fmastodon-installer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjakejarvis%2Fmastodon-installer/lists"}