diff --git a/content/configuration/1.general.md b/content/configuration/1.general.md index a13b58ca..4487bb35 100644 --- a/content/configuration/1.general.md +++ b/content/configuration/1.general.md @@ -52,6 +52,18 @@ When `LICENSE_KEY` or `LICENSE_TOKEN` is set in the environment, any license key All `SERVER_*` environment variables are merged with `server` instance properties created from [http.Server](https://github.com/nodejs/node/blob/master/doc/api/http.md#class-httpserver). This allows to configure server behind a proxy, a load balancer, etc. Be careful to not override methods of this instance otherwise you may incur into unexpected behaviors. +### Development + +These variables only apply when running Directus from source in development mode (`NODE_ENV=development`), such as when contributing to the project. They have no effect on a production build or a deployed instance. + +| Variable | Description | Default Value | +| -------------- | -------------------------------------------------------------- | ------------- | +| `DEV_APP_PORT` | Port for the Data Studio development server started by Vite. | `8080` | + +::callout{icon="i-lucide-info"} +`DEV_APP_PORT` is separate from the API's `PORT`. When it is set, the development server fails to start if the port is already in use. When it is left unset, the server starts on `8080` and automatically increments to the next free port if `8080` is taken. Invalid values (non-integer, below `1`, or above `65535`) are ignored and fall back to `8080` with a warning. +:: + ## First Admin User The following commands set details for the first admin user created when the project is bootstrapped.