{"id":13674353,"url":"https://frab.github.io/frab/","last_synced_at":"2025-04-28T14:31:11.994Z","repository":{"id":2083797,"uuid":"1479403","full_name":"frab/frab","owner":"frab","description":"conference management system","archived":false,"fork":false,"pushed_at":"2024-04-11T13:39:04.000Z","size":6500,"stargazers_count":691,"open_issues_count":97,"forks_count":150,"subscribers_count":32,"default_branch":"main","last_synced_at":"2024-04-11T15:07:34.502Z","etag":null,"topics":["hacktoberfest"],"latest_commit_sha":null,"homepage":"https://frab.github.io/frab/","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/frab.png","metadata":{"files":{"readme":"README.PaaS.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null},"funding":{"custom":[]}},"created_at":"2011-03-14T18:11:57.000Z","updated_at":"2024-04-15T15:21:30.435Z","dependencies_parsed_at":"2023-07-06T10:46:04.595Z","dependency_job_id":"2ce044e0-3514-48d5-a757-2c909d45a661","html_url":"https://github.com/frab/frab","commit_stats":{"total_commits":2129,"total_committers":68,"mean_commits":"31.308823529411764","dds":0.7407233442930954,"last_synced_commit":"7bccac5653c67e403cc5436b8ad8465efa21798d"},"previous_names":[],"tags_count":13,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/frab%2Ffrab","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/frab%2Ffrab/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/frab%2Ffrab/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/frab%2Ffrab/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/frab","download_url":"https://codeload.github.com/frab/frab/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251330208,"owners_count":21572243,"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":["hacktoberfest"],"created_at":"2024-08-02T11:00:47.341Z","updated_at":"2025-04-28T14:31:10.526Z","avatar_url":"https://github.com/frab.png","language":"Ruby","funding_links":[],"categories":["Software","Conference Management"],"sub_categories":["Conference Management","XMPP"],"readme":"# Deploying Frab with Dokku\n\n[Dokku](http://dokku.viewdocs.io/dokku/) is a Platform-as-a-Service (PaaS) engine which allows for simple `git push` deployments.\nIt builds on [`herokuish`](https://github.com/gliderlabs/herokuish) and is highly customizable via [plugins](http://dokku.viewdocs.io/dokku/plugins/).\n\nTo deploy a Frab application with `dokku`, please proceed as follows from within your local source repository.\n\n## 1. Setting up Dokku\n\nGiven you have access to your Dokku service via a simple shell alias (`alias dokku='ssh -t dokku@\u003cDOKKU_HOST\u003e'`) and `dokku version` works, you will also need to install [the PostgreSQL](https://github.com/dokku/dokku-postgres) and [Let's Encrypt](https://github.com/dokku/dokku-letsencrypt) plugins.\n\nYou can then proceed setting up your application.\n\n```\ndokku create \u003cAPP_NAME\u003e\n```\n\nSet up your Ruby version:\n\n```\ndokku config:set CUSTOM_RUBY_VERSION 2.3\n```\n\n## 2. Setting up frab\n\nFor your application you need\n\n1. an [environmental configuration](http://12factor.net/config),\n2. an [attached database](http://12factor.net/backing-services) and\n3. a valid TLS setup due to Rails' [CSRF](https://en.wikipedia.org/wiki/Cross-site_request_forgery) protection.\n\n### Environmental configuration\n\nYour local `.env` environment file could then look similarly to\n\n```\nSECRET_KEY_BASE=\u003cshould_be_longer_than_32_chars, 'pwgen 32' suffices\u003e\nFRAB_HOST=\u003cAPP_FQDN=APP_NAME.DOKKU_HOST\u003e\nFRAB_PROTOCOL=\u003chttp|https\u003e\nFROM_EMAIL=\u003csender@host.tld\u003e\nSMTP_ADDRESS=\u003cSMTP MX\u003e\nSMTP_PORT=25\nSMTP_NOTLS=\u003ctrue|false\u003e\nSMTP_USER_NAME=\nSMTP_PASSWORD=\nBUNDLE_WITHOUT=development:test:mysql:sqlite3\nRAILS_SERVE_STATIC_FILES=true\n```\n\nPipe this configuration to Dokku with\n\n    dokku config:set \u003cAPP_NAME\u003e `paste -d \" \" -s .env`\n\n### Database setup\n\nThe associated database service is created and linked with\n\n    dokku postgresql:create \u003cDB_NAME\u003e\n    dokku postgresql:link \u003cAPP_NAME\u003e \u003cDB_NAME\u003e\n\n`dokku config \u003cAPP_NAME\u003e` should now report your whole configuration.\n\n### TLS setup\n\nThis will only work after your application is (already partly) running, due to the way the Let's Encrypt plugin works, so let's\n\n## 3. Deploy Frab!\n\nAdd the desired `APP_FQDN` domain to the application and remove the standard Dokku subdomain `APP_NAME.DOKKU_HOST` for later generation of a valid TLS certificate.\n\n### domain configuration\n\n    dokku domains:add \u003cAPP_NAME\u003e \u003cAPP_FQDN\u003e\n    dokku domains:remove \u003cAPP_NAME\u003e \u003cAPP_NAME.DOKKU_HOST\u003e\n\nOnly then issue\n\n### git deployment\n\n    git remote add dokku dokku@\u003cDOKKU_HOST\u003e:\u003cAPP_NAME\u003e\n    git push dokku master\n\n### TLS setup\n\nTo omit an appearing **502 Bad Gateway** error, we finish the TLS setup with\n\n    dokku letsencrypt \u003cAPP_NAME\u003e\n\nAfter this has completed successfully, manually load the database schema\n\n    dokku run \u003cAPP_NAME\u003e bundle exec rake db:setup\n\n---\n\nThat's it. Your application should be running at `\u003cPROTO\u003e://\u003cAPP_NAME\u003e.\u003cDOKKU_HOST\u003e`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/frab.github.io%2Ffrab%2F","html_url":"https://awesome.ecosyste.ms/projects/frab.github.io%2Ffrab%2F","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/frab.github.io%2Ffrab%2F/lists"}