Meet Khargo

Khargo is a Go (golang) HTTP file server with a GridFS (MongoDB) backend. If you want to store files in GridFS and serve them over HTTP, Khargo can help you out. It supports memory-efficient streaming of large files, and intelligent gzipping.


Launch Khargo from the command line:

$ ./khargo
2013/05/06 16:45:41 Connecting to mongodb://localhost:27017/test with strong consistency.
2013/05/06 16:45:41 Listening on :8000

Khargo accepts four command line arguments

Khargo does not daemonize.

The Khargo repository includes a Procfile that will launch Khargo as a 'web' proc. It expects $PORT and $DBURL environment variables to be set.


Khargo is written in go. The only requirement outside the Go standard library is the mgo driver:

go get labix.org/v2/mgo
go build khargo.go


Khargo emits logs to stdout. Log lines look like this:

2013/05/06 15:05:03 - GET - /myfile.txt - curl/7.21.4 (universal-apple-darwin11.0) libcurl/7.21.4 OpenSSL/0.9.8r zlib/1.2.5 -  - 200 - 14.024ms

That format is:

date time ip - method - path - user agent - referer - status - response time

Uploading Files

The 'mongo' command line client is usually also installed with a mongofiles utility that you can use to upload files to GridFS. Here's an example of using it to upload this README file, from one directory up:

mongofiles put README.rst --local khargo/README.rst -h mymongoserver --db myfilesdb

The Name

I previously created a Python program called Khartoum that could serve GridFS files over http. Khargo is a rewrite in Go.