Cimarron is a zero-configuration http server. It's ideal for development and testing.
Directly from NPM
npm install cimarron -g
You can clone it from Github too:
git clone https://github.com/fcingolani/cimarron.git cd cimarron npm install . -g
cd into a directory, then run
cimarron; a browser window will be open pointing to your recently started Web Server.
cd DIRECTORY cimarron
cimarron does not require any configuration to start serving your content. That doesn't mean it's not possible to configure it.
Configuration is done using a
Cimarronfile, which can be one of two flavours:
Cimarronfile.json inside the directory you want to serve:
In fact those are the default values used when you don't create a
In case you want to add more routes, just add them to the routes array:
Remember, it's not required to define every property, forementioned defaults will be used.
cimarron will listen to. Default: 0.0.0.0.
Port number which
cimarron will listen to. In fact, it will search for a free port incrementally until it finds one, starting in the selected port. Default: 8000.
If false, won't show the
cimarron banner on start. Default: true.
If false, won't log requests to stdout. Default: true.
An object to define the mountpoints of your application.
An array of URLs to open automatically in your browser when
cimarron starts. It will open each URL in a browser tab!