"Launch your own crowdfunding site... without touching a line of code"
But if you're here—well, maybe you want to touch some code.
Demo
You can play with a complete working demo at demo.crowdhoster.com/admin
Use these credentials to log in:
email: [email protected] | password: crowdhoster
Quick Links:
"I want to launch my own campaign without touching any code."
Head to the main Crowdhoster page.
"I want help customizing my Crowdhoster page."
Check out this Crowdhoster setup guide.
"I want to contact the Crowdhoster team."
Email us directly: [email protected]
To run Crowdhoster you'll need the following prerequisites installed:
- Homebrew (for downloading software packages)
$ ruby -e "$(curl -fsSL https://raw.github.com/Homebrew/homebrew/go/install)"
- Git (version control)
$ brew install git
- RVM, ruby 1.9.3, and the Rails gem
$ \curl -L https://get.rvm.io | bash -s stable --rails --ruby=1.9.3
$ rvm use 1.9.3 --default
-
Postgres (database)
-
ImageMagick (image processing software)
$ brew install imagemagick
- If you recently upgraded to OS X Mavericks (10.9) or got a new Mac computer and are having issues with the json gem during the bundle process, you may need to install the Command Line Developer Tools using the following command and clicking Install when prompted:
$ xcode-select --install
To run Crowdhoster you'll also need to sign up for the following:
- a Balanced account (test marketplace and live marketplace)
- the Crowdtilt API - Email [[email protected]](mailto:[email protected]?subject=API Key Request for Crowdhoster&body=Hi! I'd like to deploy a Crowdhoster app. The Github readme sent me here to ask for an API key. Thanks!) to get your API keys
- AWS (free) and set up a bucket for your assets. The bucket should be in the US Standard (us-east-1) zone.
- Mailgun (free)
Get started by:
-
Downloading a .zip of the latest release to your local machine
or
-
Creating a fork of Crowdhoster and cloning it to your local machine.
After you've got the repo on your local machine, switch to the newly created project directory
$ cd {DIRECTORY}
Create a .env file in the project root…easiest way is to create a copy of the .env.example file
$ cp .env.example .env
Then open up the .env file and fill in the variables with your app_name and credentials. Leave ENABLE_ASSET_SYNC set to 'true' if you plan to use AWS to host your assets (recommended). The bucket for asset syncing should be in the US Standard (us-east-1) zone.
The SECRET_TOKEN variable should be at least 30 characters and all random, no regular words or you'll be exposed to dictionary attacks. You can generate a new one by running this command from the root of your project directory:
$ rake secret
Important: Your APP_NAME must not have a space in it. Underscores and hypens are accepted.
APP_NAME=myawesomeapp
CROWDTILT_SANDBOX_KEY=crowdtiltsandboxkey
CROWDTILT_SANDBOX_SECRET=crowdtiltsandboxsecret
ENABLE_ASSET_SYNC=true
AWS_BUCKET=awsbucket
AWS_ACCESS_KEY_ID=awsaccesskey
AWS_SECRET_ACCESS_KEY=awssecretaccesskey
MAILGUN_DOMAIN=myawesomeapp.mailgun.org
MAILGUN_PASSWORD=mailgunpassword
[email protected]
SECRET_TOKEN=secrettoken
Install the gems
$ bundle install
Create and migrate the DB
$ foreman run rake db:create
$ foreman run rake db:migrate
Start the server
$ foreman start
Run the console
$ foreman run rails c
Create a new Heroku app
$ heroku create {APP NAME}
Enable the use of environment variables during asset precompiling
$ heroku labs:enable user-env-compile
Install the Heroku config plugin if you don't already have it installed
$ heroku plugins:install git://github.com/ddollar/heroku-config.git
Push the configuration to Heroku.
NOTE: If you have already written config vars to Heroku, they will not be overwritten unless you pass the --overwrite flag as well.
$ heroku config:push
Deploy the code to Heroku
$ git push heroku master
Migrate the database
$ heroku run rake db:migrate
Launch the app!
$ heroku open
(Optional) It is highly recommended to install the Papertrail addon to create searchable logs should you run into issues. The "choklad" level is free.
$ heroku addons:add papertrail:choklad
Looking to help make Crowdhoster better?
Our feature development roadmap and bugs are inputted as issues. See a complete list by clicking here.
Contribute by forking the repo and working on a branch. Submit your changes via pull request.
A more complete contribution and style guide is coming soon!
Want to get in touch? Email [email protected].
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Brought to you by the team at Crowdtilt // Group fund anything