{"id":27390255,"url":"https://github.com/ailispaw/mastodon-barge","last_synced_at":"2026-04-11T02:06:47.324Z","repository":{"id":89119638,"uuid":"88378118","full_name":"ailispaw/mastodon-barge","owner":"ailispaw","description":"Mastodon on Barge with Vagrant","archived":false,"fork":false,"pushed_at":"2018-09-04T02:01:49.000Z","size":47,"stargazers_count":3,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-07-07T15:54:20.643Z","etag":null,"topics":["barge","docker","docker-compose","mastodon","vagrant"],"latest_commit_sha":null,"homepage":"","language":"Dockerfile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ailispaw.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2017-04-15T22:42:19.000Z","updated_at":"2024-05-31T02:00:27.000Z","dependencies_parsed_at":"2023-07-07T10:31:55.354Z","dependency_job_id":null,"html_url":"https://github.com/ailispaw/mastodon-barge","commit_stats":{"total_commits":63,"total_committers":1,"mean_commits":63.0,"dds":0.0,"last_synced_commit":"a716c577518092b947d8d433b853de1b6d75aa2b"},"previous_names":[],"tags_count":33,"template":false,"template_full_name":null,"purl":"pkg:github/ailispaw/mastodon-barge","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ailispaw%2Fmastodon-barge","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ailispaw%2Fmastodon-barge/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ailispaw%2Fmastodon-barge/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ailispaw%2Fmastodon-barge/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ailispaw","download_url":"https://codeload.github.com/ailispaw/mastodon-barge/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ailispaw%2Fmastodon-barge/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264502389,"owners_count":23618591,"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":["barge","docker","docker-compose","mastodon","vagrant"],"created_at":"2025-04-13T19:39:31.607Z","updated_at":"2026-04-11T02:06:47.270Z","avatar_url":"https://github.com/ailispaw.png","language":"Dockerfile","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Mastodon on Barge with Vagrant\n\n[Mastodon](https://github.com/tootsuite/mastodon) is a free, open-source social network server.\n\u003e A decentralized solution to commercial platforms, it avoids the risks of a single company monopolizing your communication. Anyone can run Mastodon and participate in the social network seamlessly.\n\u003e\n\u003e An alternative implementation of the GNU social project. Based on ActivityStreams, Webfinger, PubsubHubbub and Salmon.\n\nThis repo shows how to run a Mastodon instance on [Barge](https://atlas.hashicorp.com/ailispaw/boxes/barge) with [Vagrant](https://www.vagrantup.com/) instantly.\n\n***Note: You may find `LOCAL_HTTPS=false` in `.env.provision` here, therefor, it's just for a local test and don't use this setting in the public.***\n\n## Requirements\n\n- [VirtualBox](https://www.virtualbox.org/)\n- [Vagrant](https://www.vagrantup.com/)\n\n## Boot up\n\n```\n$ vagrant up\n```\n\nOr you can do the same procedure one by one as below.\n\n### Create a VM\n```\n$ vagrant up --no-provision\n```\n\n### Build a Mastodon Docker image\n```\n$ vagrant provision --provision-with build\n```\n\n### Configure .env.prodinction with secrets\n```\n$ vagrant provision --provision-with config\n```\n\n### Set up the database and assets\n```\n$ vagrant provision --provision-with setup\n```\n\n### Run a new Mastodon instance\n```\n$ vagrant provision --provision-with mastodon\n```\n\nCf.) https://github.com/tootsuite/mastodon/tree/v1.2#running-with-docker-and-docker-compose\n\n## Sign up for the instance\n```\nhttp://localhost:3000/\n```\n\n## Login to the instance\n\nYou will receive a confirmation email to activate your account and click a link in the email.\n\n```\nhttp://localhost:1080/\n```\n\nOr you can authorize yourself manually from your local console as below, just in case of missing the email or whatever.\n\n```\n$ vagrant ssh\n[bargee@barge ~]$ cd /opt/mastodon\n[bargee@barge mastodon]$ docker-compose run --rm web rails mastodon:confirm_email USER_EMAIL=\u003cyour email address\u003e\n```\n\nCf.) https://github.com/tootsuite/documentation/blob/master/Running-Mastodon/Administration-guide.md#confirming-users-manually\n\n## Make an administrator\n\n```\n[bargee@barge mastodon]$ docker-compose run --rm web rails mastodon:make_admin USERNAME=\u003cyour username\u003e\n```\n\nNow you can access to the admin page.\n```\nhttp://localhost:3000/admin/settings\n```\n\nCf.) https://github.com/tootsuite/documentation/blob/master/Running-Mastodon/Administration-guide.md#turning-into-an-admin\n\n## Upgrade Mastodon\n\n### Stop the instance\n\n```\n$ vagrant ssh\n[bargee@barge ~]$ cd /opt/mastodon\n[bargee@barge mastodon]$ docker-compose down\n```\n\n### Backup\n\n```\n[bargee@barge mastodon]$ cd ..\n[bargee@barge opt]$ sudo mv mastodon mastodon.bak\n```\n\n### Upgrade this repo\n```\n$ git fetch\n$ git checkout \u003cnew version\u003e\n```\n\n### Build a new Mastodon Docker image\n```\n$ vagrant provision --provision-with build\n```\n\n### Restore configuration files and folders\n\n```\n[bargee@barge ~]$ cd /opt/mastodon\n[bargee@barge mastodon]$ sudo cp -pR ../mastodon.bak/public .\n[bargee@barge mastodon]$ sudo cp /vagrant/.env.production .\n```\n\nAnd then you have to copy the secrets from `/opt/mastodon.bak/.env.production`.\n\n### Upgrade the database and assets\n\nFollow an upgrade instruction in the release notes.\nhttps://github.com/tootsuite/mastodon/releases\n\n### Restart the Mastodon instance\n```\n$ vagrant provision --provision-with mastodon\n```\n\nCf.) https://github.com/tootsuite/documentation/blob/master/Running-Mastodon/Production-guide.md#things-to-look-out-for-when-upgrading-mastodon\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Failispaw%2Fmastodon-barge","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Failispaw%2Fmastodon-barge","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Failispaw%2Fmastodon-barge/lists"}