Add Docker environment variables documentation

- Update environment-variables.mdx with Docker-specific environment variable guidance
- Add environment variable sections to docker-development.mdx and docker.mdx
- Provide instructions for updating environment variables in Docker containers
- Include a warning about properly recreating containers when changing environment variables
This commit is contained in:
Julien Nahum 2025-02-27 15:55:50 +08:00
parent b388c729ce
commit c9dbc79f75
3 changed files with 34 additions and 2 deletions

View File

@ -65,4 +65,28 @@ There are dedicated configuration pages available for more detailed setup instru
import CloudVersion from "/snippets/cloud-version.mdx";
<CloudVersion/>
<CloudVersion/>
## Docker Environment Variables
When running OpnForm with Docker, there are some important considerations for handling environment variables:
### Updating Environment Variables
When changing environment variables in your `.env` files, you need to recreate the containers for the changes to take effect. Simply restarting the containers is not sufficient as Docker only loads environment variables when containers are created.
To apply new environment variable changes:
```bash
# For a specific service (e.g., ui)
docker compose down ui
docker compose up -d ui
# For all services
docker compose down
docker compose up -d
```
<Warning>
A simple `docker compose restart` will not reload environment variables from your `.env` files. You must use `down` and `up` commands to recreate the containers.
</Warning>

View File

@ -183,4 +183,8 @@ If hot reload isn't working:
3. Try restarting the UI container:
```bash
docker compose -f docker-compose.dev.yml restart ui
```
```
## Environment Variables
For detailed information about environment variables and how to update them in Docker, see our [Environment Variables](/configuration/environment-variables#docker-environment-variables) documentation.

View File

@ -135,6 +135,10 @@ services:
- ./custom-nginx.conf:/etc/nginx/conf.d/default.conf
```
## Environment Variables
For detailed information about environment variables and how to update them in Docker, see our [Environment Variables](/configuration/environment-variables#docker-environment-variables) documentation.
## Maintenance
### Updates