jonathan/hostr
jonathan/hostr
1
0
Fork 0
Code Issues Pull requests 4 Projects Releases Packages 1 Wiki Activity Actions
A project I started over ten years ago when I set out to learn web development. Since then it's seen over 100,000 signups and served up over 2 billion file downloads https://hostr.co
37 commits 12 branches 0 tags 13 MiB
Find a file
Jonathan Cremin fc340be83d Add image unit test to testing task
2015-08-23 19:17:33 +01:00
api Fix events stuff, improve errors 2015-08-23 01:31:53 +01:00
lib Remove Docker stuff for now 2015-08-23 19:14:03 +01:00
test Fix failing image and login tests 2015-08-22 23:19:20 +01:00
web Fix dropdown overlay css being hidden 2015-08-23 16:57:48 +01:00
.buildpacks Initial commit. 2015-08-03 22:06:40 +01:00
.eslintrc Initial commit. 2015-08-03 22:06:40 +01:00
.gitignore Ignore minigun test files 2015-08-22 16:18:09 +01:00
app.js Remove Docker stuff for now 2015-08-23 19:14:03 +01:00
CHECKS Initial commit. 2015-08-03 22:06:40 +01:00
circle.yml Remove Docker stuff for now 2015-08-23 19:14:03 +01:00
init.js Initial commit. 2015-08-03 22:06:40 +01:00
package.json Add image unit test to testing task 2015-08-23 19:17:33 +01:00
Procfile Initial commit. 2015-08-03 22:06:40 +01:00
README.md Remove Docker stuff for now 2015-08-23 19:14:03 +01:00

README.md

Hostr Circle CI

About

Hostr is a project I started almost ten years ago when I set out to learn web development. Since then it's seen over 100,000 signups and served up over 2 billion file downloads.

It has been through many iterations, but in its current incarnation Hostr is built using Babel and Koa. The frontend is built with Angular, for now.

Getting Started

Runtimes

Currently tested and runs on iojs 2.5.0, probably works on earlier releases and on node. Does yet not work on iojs > 3 due to the NAN changes introduced.

Dependencies

You'll need graphicsmagick for image thumbnailing, everything else is taken care of by an npm install.

Enviroment Variable Configuration

AWS_ACCESS_KEY_ID

AWS_SECRET_ACCESS_KEY

AWS_BUCKET

MANDRILL_KEY

EMAIL_FROM - defaults to nobody@example.com

REDIS_URL - defaults to redis://localhost:6379

MONGO_URL - defaults to mongodb://localhost:27017/hostr

LOCAL_PATH - defaults to ~/.hostr/uploads.

BASE_URL - defaults to https://localhost:4040

FILE_HOST - used by API for absolute file urls, defaults to $BASE_URL

API_URL - defaults to /api

PORT - defaults to 4040.

VIRUSTOTAL - API key enables Virustotal integration.

SENTRY_DSN - DSN enables Sentry integration.

Additionally, Hostr uses debug so you can use the DEBUG environment variable something like DEBUG=hostr* to get debug output.

Deploying to Heroku

Because it uses iojs and graphicsmagick runtimes hostr needs an env variable for BUILDPACK_URL set to https://github.com/ddollar/heroku-buildpack-multi.git.

You'll also need to add Heroku Redis and a MongoDB addon.

Usage

Start the app

$ npm start

This will install and build the frontend too.

Run the tests

$ npm test

Running the tests will also set the indexes required for Mongo.

Licence

My primary motivation is to get to work on Hostr in public. Contributions are welcome and all Javascript is MIT licenced, however the brand is not. The brand includes the name, logo images, CSS and marketing HTML.