# Local Provider

Use the local provider to store files in a local filesystem where your application is running.  Behind the scenes it leverages the Java `nio` package to provide concurrency, atomicity, and non-blocking operations.

## Configuration

### Example

<pre class="language-json" data-title="config/ColdBox.cfc"><code class="lang-json">moduleSettings = {
<strong>  "cbfs": {
</strong>	// The default disk with a reserved name of 'default'
	"defaultDisk" : "myStorage",
	// Register the disks on the system
	"disks"       : {
	  // Your default application storage
	  "myStorage" : {
		"provider"   : "Local",
		"properties" : { 
			"path" : "#controller.getAppRootPath()#.myStorage",
			"diskUrl" : function(){
				return variables.controller
					.getRequestService()
					.getContext()
					.getHtmlBaseUrl()
					&#x26; "storage/.mystorage/";
			}
		}
	  }
	}
  }
};
</code></pre>

### Properties

When configuring your local disks, the following properties are available:

<table><thead><tr><th width="220">Property</th><th width="114">Type</th><th width="129">Default</th><th>Description</th></tr></thead><tbody><tr><td><code>autoExpand</code></td><td><code>Boolean</code></td><td>false</td><td>If <strong>true</strong>, it will use an <code>expandPath()</code> on the path property. Else it leaves it as is.</td></tr><tr><td><code>diskUrl</code></td><td><code>http(s)</code></td><td><code>null</code></td><td>The public disk Url.  This is used to create file URLs and temporary URLs. This should point to the root path but in a web-accessible format.</td></tr><tr><td><code>path</code></td><td><code>string</code></td><td>--</td><td>The relative or absolute path of where to store the file system.</td></tr><tr><td><code>uploadMimeAccept</code></td><td><code>string</code></td><td>*</td><td>The mime types which are accepted via the upload method. Defaults to all.</td></tr><tr><td><code>visibility</code></td><td><code>string</code></td><td><code>public</code></td><td>The default visibility when creating files.  Available options are <code>public, private, readonly</code></td></tr></tbody></table>
