Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Branch: master
Fetching contributors…

Cannot retrieve contributors at this time

60 lines (46 sloc) 1.865 kB


Run a connect server. The built in Grunt server task is terrific for the great majority of cases, however sometimes you just want to ability to run a web server on a local file system and interact with the files using a web browser. For that reason, grunt-connect's default behaviour is to run indefinitely.

Getting Started

Install this grunt plugin next to your project's grunt.js gruntfile with: npm install grunt-connect

Then add this line to your project's grunt.js gruntfile:




  • port - port to listen, default 1337
  • base - base directory, default ".", unless combine is used
  • combine - combine multiple bases into single server. If file is not found in first one, it tries to find in second, and so on. If base is also specified, it is on first position.

Content of directories is listed. In case multiple bases, it lists only files from first base with given directory (directory contents are not combined).

Since, these tasks are essentially asynchronous tasks that don't close. It's best to target them directly. For example, given the following configuration:

  connect: {
    example: {
      port: 1337,
      base: 'example'
    test: {
      port: 1338,
      base: 'test',
      keepAlive: false
    meta: {
      port: 1339,
      base: 'tasks'
    combined: {
      port: 1340,
      combine: [

One might target the meta server using grunt connect:meta


Copyright (c) 2012 Merrick Christensen Licensed under the MIT license.

Jump to Line
Something went wrong with that request. Please try again.