These config vars are used to define the behaviour of Gavel. There are descriptions tagged to these fields that provide some context.
This field must be set to true in order for any of these config items to work as environment variables.
This item controls the password to the administrator account for gavel. Make sure that this is a secure password, and kept secret. An easy way to get a secure password is this Random Key Generator. More details about the admin panel can be found here.
This defines the base URL of the Gavel application. The app uses this primarily to fill information in correspondence. The base url of apps on heroku is
https://<app-name>.herokuapp.com/. However, you can customize this to something like
https://judge.hackdfw.com through heroku by using the steps provided on the heroku custom domains page.
Setting this to false will disallow the app from sending emails to judges. This must be set to true in order to send emails of any kind. Please read more about email configuration below. Notably in the EMAIL_PROVIDER section.
This field defines the service that gavel will use to send emails. Currently, the only services that are available are smtp, mailgun, and sendgrid. Each service requires certain other fields to be populated as detailed below:
|DISABLE_EMAIL = false||DISABLE_EMAIL = false||DISABLE_EMAIL = false|
Please ensure that the
EMAIL_PROVIDER field is populated with either
Email addresses sent from the email provider will be sent from this address. This email address must be valid and an address that the email provider can successfully send from. All valid email providers are dependent on this variable.
This should be populated with the SMTP host that you want gavel to use. This is giong to vary depending on the email provider you use. By defualt, it is
smtp.gmail.com which is the SMTP host for gmail. To authenticate SMTP, please see EMAIL_USER, and EMAIL_PASSWORD.
This is the SMTP port that will be appended to EMAIL_HOST to authenticate SMTP.
This is the API Key that mailgun uses to authenticate the MAILGUN_DOMAIN.
This is the mailgun domain that is authenticated using MAILGUN_API_KEY.
This is the API key that Gavel uses to authenticate the sendgrid service.
The secret key is used to hash requests and CSRF tokens. This must be a long, randomly generated alphanumeric string to be effective.
This defines whether your gavel instance is set up for judging a virtual event. Setting this to true produces embedded demo videos and long project description in gavel. Optimized for judging on a computer rather than mobile phone.
Properties for a "Virtual Event"
CSV Format: Project Name, Description, Tagline, Video URL, Submission URL, Submission Website
|Description||self-explanatory - lies above the buttons|
|Tagline||A short, one sentence description for the project|
|Video URL||A video link (Youtube, Vimeo, etc.)|
|Submission URL||Link to the Devpost project|
|Submission Website||A link to the final product (Heroku app, etc.)|
Sample CSV Input (Note: put this onto a single line when copying)
"Pied Piper","a powerful compression tool brewed in the mind of Richard Hendricks", "always blue! always blue!","https://www.youtube.com/watch?v=dQw4w9WgXcQ", "https://devpost.com","https://google.com"
The last column "Submission Website" is optional and creates a greyed-out button if it does not exist.
The image below shows the output that would be rendered.