> For the complete documentation index, see [llms.txt](https://docsv1.empirica.ly/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docsv1.empirica.ly/guides/the-settings-file.md).

# The Settings File

Emprica is configured with **settings** stored as `json` data.

You will need to create a **settings file** to set up your app. This will be a `.json` file, which is often named`settings.json` (or `local.json` or `deploy.json`).

**The settings file contains information that you do not want to share with the public**, such as your admin password and database security credentials. Hence you should keep it private. If you put your code on an online version-control repository (e.g., GitHub), we suggest you ***add the name of your settings file to the\*\*\*\* ****`.gitignore`**** \*\*\*\*file of your project.***

The settings file contains a JSON object `{}` in which there are other objects separated by `,`

```javascript
{
    "galaxy.meteor.com": {
        
    },
    "admins": [
        {
            "username": "myusername",
            "password": "mypassword"
        }
    ],
    "public": {  
    }
}
```

To run your app locally with your settings as set in the settings file, use:

```
meteor --settings settings.json
```

## Uses

The settings file is useful for:

{% content-ref url="/pages/-McUuO\_zLytU0OSDCkMc" %}
[Specifying Login Details](/guides/the-settings-file/specifying-login-details.md)
{% endcontent-ref %}

{% content-ref url="/pages/-MeYmiTudC\_682iD2eOa" %}
[Setting player ids via URL queries](/guides/the-settings-file/id-url-queries.md)
{% endcontent-ref %}

{% content-ref url="/pages/-MeYmsRwl-Htl9bLpyZw" %}
[Connecting Locally to MongoDB](/guides/the-settings-file/connecting-locally-to-mongodb.md)
{% endcontent-ref %}