FAQ

Q: The CSS or Javascripts file are not loading
A: In Teambox, CSS and Javascript file are in absolute path. If the domain name in your teambox.yml is incorrect, the application will not work. Edit teambox.yml and restart the server.

Q: The application is working, but when I signup, I get a “…smtp…” related error
A: Teambox is extensively using email for confirmation, notification, reply. When you create your first account, Teambox send an email to confirm the account. If you can’t pass this step, its likely that your smtp configuration is not right. We suggest you to use sendgrid service, which is free for 500 email per day. It’s also easy to set up if you’re using Heroku, refer to Heroku’s installation guide.

Q: I can’t get the application to work in a sub-directory of my domain, like mydomain.com/teambox
A: Like a lot of the Rails application, teambox is designed to work in its own domain/subdomain. You’ll have to make some modification to the code make it work within a sub-directory. We strongly suggest you to setup a sub-domain instead, like “teambox.mydomain.com”.

Q: I upgraded and now I have some part of the application failing
A: Make sure its not a bad merge issue. If you did modification to the code base, you’ll need to merge them in the new version. For this a git related topic, I suggest to look at the documentation about git here on Github.

Q: I try to run “bundle install” but it fails
A: Make sure you have a recent version of bundler installed. You’ll need at least 1.0 (you can check with bundle -v). There is a lot of information on bundler if you take the time to search, its now the standard way to manage dependancy for Rails application. Google your console output, it’s likely that you’ll find a solution. This is probably not a teambox specific problem.

Q: I’m trying to deploy but passenger throws an error…
A: When troubleshooting your deployment, you should alway make sure that you can run the application with mongrel directly, using the “script/rails server -e production” command in the directory of the application. It will be more easy for you to solve installation/dependancy issue this way.

Q: I try to run “script/server” but it fails
A: The command to invoke the server has changed. You should now run script/rails server instead.