Browse files

Updated Readme with submodules

  • Loading branch information...
1 parent b5d2613 commit 957a090e89d149603cf84ca06d388c1cf79bc0d0 @freenerd freenerd committed Apr 1, 2012
Showing with 24 additions and 4 deletions.
  1. +24 −4 README
@@ -6,14 +6,25 @@ rvm install 1.9.3
checkout repo and install shitz:
-git clone
-cd happstr
+git clone
+cd happstr-web
+setup submodule read-write access:
+git submodule init
+open the file .git/config in your editor and change the line
+ [submodule "public"]
+ url = git://
+ [submodule "public"]
+ url =
+git submodule update
+setup environment:
echo 'rvm ruby-1.9.2@happstr --create' > .rvmrc
-cd ../happstr
+cd ../happstr-web
gem install bundler
bundle install
Install Mongo Datastore:
(if you have no brew, install like this:
/usr/bin/ruby -e "$(curl -fsSL"
@@ -27,3 +38,12 @@ mongod run --config /usr/local/Cellar/mongodb/2.0.3-x86_64/mongod.conf
run sinatra:
+optional install shotgun to have automatic reload of sinatra app on changes:
+gem install shotgun
+why this complicated submodule setup?
+Heroku has to be able to pull the submodule itself from the repository, but it doesn't use ssh keys we know. So it is not able to access the repository with read-write access, but only via read-only. These modes have different URLs ( vs. git:// Locally, we want the first URL, on Heroku we want to have the second. The way git handles submodules is that is copies the check-in file .gitmodules to .git/config for your local repo instance. You can change your .git/config to the read-write url before updating the submodules whereas Heroku will always use the URL in .gitmodules.
+You can read more about all this here:

0 comments on commit 957a090

Please sign in to comment.