# 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docsv1.empirica.ly/guides/the-settings-file.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.