Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/frab/frab
conference management system
https://github.com/frab/frab
hacktoberfest
Last synced: 14 days ago
JSON representation
conference management system
- Host: GitHub
- URL: https://github.com/frab/frab
- Owner: frab
- License: other
- Created: 2011-03-14T18:11:57.000Z (over 13 years ago)
- Default Branch: main
- Last Pushed: 2024-04-11T13:39:04.000Z (7 months ago)
- Last Synced: 2024-04-11T15:07:34.502Z (7 months ago)
- Topics: hacktoberfest
- Language: Ruby
- Homepage: https://frab.github.io/frab/
- Size: 6.2 MB
- Stars: 691
- Watchers: 32
- Forks: 150
- Open Issues: 97
-
Metadata Files:
- Readme: README.PaaS.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- awesome-conferences - frab
- awesome-starred - frab/frab - conference management system (hacktoberfest)
README
# Deploying Frab with Dokku
[Dokku](http://dokku.viewdocs.io/dokku/) is a Platform-as-a-Service (PaaS) engine which allows for simple `git push` deployments.
It builds on [`herokuish`](https://github.com/gliderlabs/herokuish) and is highly customizable via [plugins](http://dokku.viewdocs.io/dokku/plugins/).
To deploy a Frab application with `dokku`, please proceed as follows from within your local source repository.
## 1. Setting up Dokku
Given you have access to your Dokku service via a simple shell alias (`alias dokku='ssh -t dokku@'`) 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.
You can then proceed setting up your application.
```
dokku create
```
Set up your Ruby version:
```
dokku config:set CUSTOM_RUBY_VERSION 2.3
```
## 2. Setting up frab
For your application you need
1. an [environmental configuration](http://12factor.net/config),
2. an [attached database](http://12factor.net/backing-services) and
3. a valid TLS setup due to Rails' [CSRF](https://en.wikipedia.org/wiki/Cross-site_request_forgery) protection.
### Environmental configuration
Your local `.env` environment file could then look similarly to
```
SECRET_KEY_BASE=
FRAB_HOST=
FRAB_PROTOCOL=
FROM_EMAIL=
SMTP_ADDRESS=
SMTP_PORT=25
SMTP_NOTLS=
SMTP_USER_NAME=
SMTP_PASSWORD=
BUNDLE_WITHOUT=development:test:mysql:sqlite3
RAILS_SERVE_STATIC_FILES=true
```
Pipe this configuration to Dokku with
dokku config:set `paste -d " " -s .env`
### Database setup
The associated database service is created and linked with
dokku postgresql:create
dokku postgresql:link
`dokku config ` should now report your whole configuration.
### TLS setup
This will only work after your application is (already partly) running, due to the way the Let's Encrypt plugin works, so let's
## 3. Deploy Frab!
Add 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.
### domain configuration
dokku domains:add
dokku domains:remove
Only then issue
### git deployment
git remote add dokku dokku@:
git push dokku master
### TLS setup
To omit an appearing **502 Bad Gateway** error, we finish the TLS setup with
dokku letsencrypt
After this has completed successfully, manually load the database schema
dokku run bundle exec rake db:setup
---
That's it. Your application should be running at `://.`.