parse-dashboard 8.0.0-alpha.2 → 8.0.0-alpha.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md
CHANGED
|
@@ -145,34 +145,127 @@ Parse Dashboard is continuously tested with the most recent releases of Node.js
|
|
|
145
145
|
|
|
146
146
|
### Options
|
|
147
147
|
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
|
153
|
-
|
|
154
|
-
| `apps
|
|
155
|
-
| `
|
|
156
|
-
| `
|
|
157
|
-
| `
|
|
158
|
-
| `
|
|
159
|
-
| `
|
|
160
|
-
| `
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
|
166
|
-
|
|
|
167
|
-
| `
|
|
168
|
-
| `
|
|
169
|
-
| `
|
|
170
|
-
| `
|
|
171
|
-
| `
|
|
148
|
+
This section provides a comprehensive reference for all Parse Dashboard configuration options that can be used in the configuration file, via CLI arguments, or as environment variables.
|
|
149
|
+
|
|
150
|
+
#### Root Configuration Keys
|
|
151
|
+
|
|
152
|
+
| Key | Type | Required | Default | CLI | Env Variable | Example | Description | Links to Details |
|
|
153
|
+
|-----|------|----------|---------|-----|--------------|---------|-------------|------------------|
|
|
154
|
+
| `apps` | Array<Object> | Yes | - | - | `PARSE_DASHBOARD_CONFIG` | `[{...}]` | Array of Parse Server apps to manage | [App Configuration](#app-configuration-apps-array) |
|
|
155
|
+
| `users` | Array<Object> | No | - | - | - | `[{...}]` | User accounts for dashboard authentication | [User Configuration](#user-configuration-users) |
|
|
156
|
+
| `useEncryptedPasswords` | Boolean | No | `false` | - | - | `true` | Use bcrypt hashes instead of plain text passwords | - |
|
|
157
|
+
| `trustProxy` | Boolean \| Number | No | `false` | `--trustProxy` | `PARSE_DASHBOARD_TRUST_PROXY` | `1` | Trust X-Forwarded-* headers when behind proxy | - |
|
|
158
|
+
| `iconsFolder` | String | No | - | - | - | `"icons"` | Folder for app icons (relative or absolute path) | - |
|
|
159
|
+
| `agent` | Object | No | - | - | `PARSE_DASHBOARD_AGENT` (JSON) | `{...}` | AI agent configuration | [AI Agent Configuration](#ai-agent) |
|
|
160
|
+
| `enableResourceCache` | Boolean | No | `false` | - | - | `true` | Enable browser caching of dashboard resources | - |
|
|
161
|
+
|
|
162
|
+
|
|
163
|
+
##### App Configuration (`apps` array)
|
|
164
|
+
|
|
165
|
+
| Parameter | Type | Optional | Default | CLI | Env Variable | Example | Description |
|
|
166
|
+
| -------------------------- | ------------------- | -------- | --------- | -------------------- | ------------------------------------ | --------------------------------- | ------------------------------------------------------------------------------------------------------------ |
|
|
167
|
+
| `appId` | String | no | - | `--appId` | `PARSE_DASHBOARD_APP_ID` | `"myAppId"` | The Application ID for your Parse Server instance. |
|
|
168
|
+
| `masterKey` | String \| Function | no | - | `--masterKey` | `PARSE_DASHBOARD_MASTER_KEY` | `"key"` or `() => "key"` | Master key for full access. Can be a String or Function returning a String. |
|
|
169
|
+
| `serverURL` | String | no | - | `--serverURL` | `PARSE_DASHBOARD_SERVER_URL` | `"http://localhost:1337/parse"` | The URL where your Parse Server is running. |
|
|
170
|
+
| `appName` | String | yes | `appId` | `--appName` | `PARSE_DASHBOARD_APP_NAME` | `"MyApp"` | Display name of the app. |
|
|
171
|
+
| `masterKeyTtl` | Number | yes | - | `--masterKeyTtl` | - | `3600` | TTL for master key cache in seconds (only when masterKey is a function). |
|
|
172
|
+
| `readOnlyMasterKey` | String | yes | - | - | - | `"myReadOnlyKey"` | Read-only master key that prevents mutations. |
|
|
173
|
+
| `clientKey` | String | yes | - | - | - | `"myClientKey"` | Client key for Parse SDK (legacy, mostly unused). |
|
|
174
|
+
| `javascriptKey` | String | yes | - | - | - | `"myJsKey"` | JavaScript key for Parse SDK (legacy, mostly unused). |
|
|
175
|
+
| `restKey` | String | yes | - | - | - | `"myRestKey"` | REST API key for server-side REST applications. |
|
|
176
|
+
| `windowsKey` | String | yes | - | - | - | `"myWindowsKey"` | Windows SDK key (legacy, mostly unused). |
|
|
177
|
+
| `webhookKey` | String | yes | - | - | - | `"myWebhookKey"` | Webhook key for Cloud Code Webhooks. |
|
|
178
|
+
| `fileKey` | String | yes | - | - | - | `"myFileKey"` | File key used for file migrations. |
|
|
179
|
+
| `graphQLServerURL` | String | yes | - | `--graphQLServerURL` | `PARSE_DASHBOARD_GRAPHQL_SERVER_URL` | `"http://localhost:1337/graphql"` | The URL where your Parse GraphQL Server is running. |
|
|
180
|
+
| `appNameForURL` | String | yes | `appName` | - | - | `"my-app"` | URL-friendly name used in dashboard URLs. |
|
|
181
|
+
| `production` | Boolean | yes | `false` | - | - | `true` | Mark as production environment. |
|
|
182
|
+
| `iconName` | String | yes | - | - | - | `"icon.png"` | Filename of app icon (requires global `iconsFolder`). |
|
|
183
|
+
| `primaryBackgroundColor` | String | yes | - | - | - | `"#FFA500"` | Primary background color (CSS value). |
|
|
184
|
+
| `secondaryBackgroundColor` | String | yes | - | - | - | `"#FF4500"` | Secondary background color (CSS value). |
|
|
185
|
+
| `supportedPushLocales` | Array<String> | yes | - | - | - | `["en","fr"]` | Supported locales for push notifications. |
|
|
186
|
+
| `preventSchemaEdits` | Boolean | yes | `false` | - | - | `true` | Prevent schema modifications through the dashboard. |
|
|
187
|
+
| `columnPreference` | Object | yes | - | - | - | `{"_User":[...]}` | Column visibility/sorting/filtering preferences. See [column preferences details](#prevent-columns-sorting). |
|
|
188
|
+
| `classPreference` | Object | yes | - | - | - | `{"_Role":{...}}` | Persistent filters for all users. See [persistent filters details](#persistent-filters). |
|
|
189
|
+
| `enableSecurityChecks` | Boolean | yes | `false` | - | - | `true` | Enable security checks under App Settings > Security. |
|
|
190
|
+
| `cloudConfigHistoryLimit` | Integer | yes | `100` | - | - | `200` | Number of historic Cloud Config values (0 to Number.MAX_SAFE_INTEGER). |
|
|
191
|
+
| `config` | Object | yes | - | - | - | `{...}` | Settings for storing dashboard config on server. |
|
|
192
|
+
| `config.className` | String | yes | - | - | - | `"DashboardConfig"` | Table name for dashboard configuration. |
|
|
193
|
+
| `scripts` | Array<Object> | yes | `[]` | - | - | `[{...}]` | Scripts for this app. See [scripts table below](#scripts). |
|
|
194
|
+
| `infoPanel` | Array<Object> | yes | - | - | - | `[{...}]` | Info panel config. See [info panel table below](#info-panel). |
|
|
195
|
+
|
|
196
|
+
##### Column Preference Configuration (`apps[].columnPreference.<className>[]`)
|
|
197
|
+
|
|
198
|
+
Each class in `columnPreference` can have an array of column configurations:
|
|
199
|
+
|
|
200
|
+
| Parameter | Type | Optional | Default | Example | Description |
|
|
201
|
+
| ------------------|---------|----------|---------|---------------|----------------------------------------------------|
|
|
202
|
+
| `name` | String | no | - | `"createdAt"` | Column/field name. |
|
|
203
|
+
| `visible` | Boolean | yes | `true` | `false` | Whether the column is visible in the data browser. |
|
|
204
|
+
| `preventSort` | Boolean | yes | `false` | `true` | Prevent this column from being sortable. |
|
|
205
|
+
| `filterSortToTop` | Boolean | yes | `false` | `true` | Sort this column to the top in filter popup. |
|
|
206
|
+
|
|
207
|
+
##### Scripts Configuration (`apps[].scripts[]`)
|
|
208
|
+
|
|
209
|
+
| Parameter | Type | Optional | Default | Example | Description |
|
|
210
|
+
| --------------------------|--------------------------------------------|----------|---------|-----------------|---------------------------------------------------|
|
|
211
|
+
| `title` | String | no | - | `"Delete User"` | Title in context menu and confirmation dialog. |
|
|
212
|
+
| `classes` | Array<String> \| Array<Object> | no | - | `["_User"]` | Classes for which script can run. |
|
|
213
|
+
| `cloudCodeFunction` | String | no | - | `"deleteUser"` | Parse Cloud Function name to execute. |
|
|
214
|
+
| `executionBatchSize` | Integer | yes | `1` | `10` | Batch size for multiple objects (runs in serial). |
|
|
215
|
+
| `showConfirmationDialog` | Boolean | yes | `false` | `true` | Show confirmation dialog before execution. |
|
|
216
|
+
| `confirmationDialogStyle` | String | yes | `info` | `critical` | Dialog style: `info` (blue) or `critical` (red). |
|
|
217
|
+
|
|
218
|
+
##### Info Panel Configuration (`apps[].infoPanel[]`)
|
|
219
|
+
|
|
220
|
+
| Parameter | Type | Optional | Default | Example | Description |
|
|
221
|
+
| --------------------|---------------------|----------|---------|--------------------|-----------------------------------------------|
|
|
222
|
+
| `title` | String | no | - | `"User Details"` | Panel title. |
|
|
223
|
+
| `classes` | Array<String> | no | - | `["_User"]` | Classes for which panel is displayed. |
|
|
224
|
+
| `cloudCodeFunction` | String | no | - | `"getUserDetails"` | Cloud Function receiving selected object. |
|
|
225
|
+
| `prefetchObjects` | Number | yes | `0` | `2` | Number of next rows to prefetch. |
|
|
226
|
+
| `prefetchStale` | Number | yes | `0` | `10` | Seconds after which prefetched data is stale. |
|
|
227
|
+
|
|
228
|
+
|
|
229
|
+
##### User Configuration (`users[]`)
|
|
230
|
+
|
|
231
|
+
| Parameter | Type | Optional | Default | CLI | Env Variable | Example | Description |
|
|
232
|
+
| ------------------|---------------------|----------|----------|------------------|---------------------------------|----------------------|----------------------------------------|
|
|
233
|
+
| `user` | String | no | - | `--userId` | `PARSE_DASHBOARD_USER_ID` | `"admin"` | Username for authentication. |
|
|
234
|
+
| `pass` | String | no | - | `--userPassword` | `PARSE_DASHBOARD_USER_PASSWORD` | `"pass"` | Password (plain or bcrypt hash). |
|
|
235
|
+
| `mfa` | String | yes | - | - | - | `"JBSWY3DPEHPK3PXP"` | MFA secret for TOTP. |
|
|
236
|
+
| `mfaAlgorithm` | String | yes | `"SHA1"` | - | - | `"SHA256"` | TOTP algorithm for MFA. |
|
|
237
|
+
| `mfaDigits` | Number | yes | `6` | - | - | `8` | Number of digits in MFA code. |
|
|
238
|
+
| `mfaPeriod` | Number | yes | `30` | - | - | `60` | MFA code validity period in seconds. |
|
|
239
|
+
| `readOnly` | Boolean | yes | `false` | - | - | `true` | Read-only access to all their apps. |
|
|
240
|
+
| `apps` | Array<Object> | yes | - | - | - | `[{...}]` | Apps user can access (all if omitted). |
|
|
241
|
+
| `apps[].appId` | String | no | - | - | - | `"myAppId"` | App ID user can access. |
|
|
242
|
+
| `apps[].readOnly` | Boolean | yes | `false` | - | - | `true` | Read-only access to this specific app. |
|
|
243
|
+
|
|
244
|
+
#### CLI & Server Options
|
|
245
|
+
|
|
246
|
+
| Parameter | Type | Optional | Default | CLI | Env Variable | Example | Description |
|
|
247
|
+
| ----------------------|---------|----------|--------------|-------------------------|------------------------------------------|-----------------| -------------------------------------------------|
|
|
248
|
+
| `host` | String | yes | `"0.0.0.0"` | `--host` | `HOST` | `"127.0.0.1"` | Host address to bind server. |
|
|
249
|
+
| `port` | Number | yes | `4040` | `--port` | `PORT` | `8080` | Port for dashboard server. |
|
|
250
|
+
| `mountPath` | String | yes | `"/"` | `--mountPath` | `MOUNT_PATH` | `"/dashboard"` | Mount path for application. |
|
|
251
|
+
| `allowInsecureHTTP` | Boolean | yes | `false` | `--allowInsecureHTTP` | `PARSE_DASHBOARD_ALLOW_INSECURE_HTTP` | `true` | Allow HTTP (use behind HTTPS proxy). |
|
|
252
|
+
| `sslKey` | String | yes | - | `--sslKey` | `PARSE_DASHBOARD_SSL_KEY` | `"/path/key"` | Path to SSL private key for HTTPS. |
|
|
253
|
+
| `sslCert` | String | yes | - | `--sslCert` | `PARSE_DASHBOARD_SSL_CERT` | `"/path/cert"` | Path to SSL certificate for HTTPS. |
|
|
254
|
+
| `cookieSessionSecret` | String | yes | Random | `--cookieSessionSecret` | `PARSE_DASHBOARD_COOKIE_SESSION_SECRET` | `"secret"` | Secret for session cookies (for multi-server). |
|
|
255
|
+
| `cookieSessionMaxAge` | Number | yes | Session-only | `--cookieSessionMaxAge` | `PARSE_DASHBOARD_COOKIE_SESSION_MAX_AGE` | `3600` | Session cookie expiration (seconds). |
|
|
256
|
+
| `dev` | Boolean | yes | `false` | `--dev` | - | - | Development mode (**DO NOT use in production**). |
|
|
257
|
+
| `config` | String | yes | - | `--config` | - | `"config.json"` | Path to JSON configuration file. |
|
|
258
|
+
|
|
259
|
+
#### Helper CLI Commands
|
|
260
|
+
|
|
261
|
+
| Command | Description |
|
|
262
|
+
| ---------------|---------------------------------------------------------------------|
|
|
263
|
+
| `--createUser` | Interactive tool to generate secure user passwords and MFA secrets. |
|
|
264
|
+
| `--createMFA` | Interactive tool to generate MFA secrets for existing users. |
|
|
172
265
|
|
|
173
266
|
### File
|
|
174
267
|
|
|
175
|
-
You can also start the dashboard from the command line with a config file.
|
|
268
|
+
You can also start the dashboard from the command line with a config file. To do this, create a new file called `parse-dashboard-config.json` inside your local Parse Dashboard directory hierarchy. The file should match the following format:
|
|
176
269
|
|
|
177
270
|
```json
|
|
178
271
|
{
|