node package manager
Orgs are free. Discover, share, and reuse code in your team. Create a free org »



Run a connect server, indefinitely. 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.

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'
    meta: {
      port: 1338,
      base: 'tasks'
    combined: {
      port: 1339,
      combine: [

One might target the meta server using grunt connect:meta


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