Configuration
Self-hosted BioNodulo is configured through environment variables and an optional config file. This page lists the most common settings.
Core environment variables
| Variable | Default | Description |
|---|---|---|
BIONODULO_SECRET_KEY | — | Required. Signing key for sessions/tokens. |
BIONODULO_DATA_DIR | /data | Where workflows, caches, and outputs live. |
BIONODULO_PORT | 8080 | HTTP port for the editor. |
BIONODULO_LOG_LEVEL | info | debug / info / warn / error. |
BIONODULO_MAX_RAM | host memory | Cap RAM available to node execution. |
BIONODULO_MAX_CONCURRENCY | CPU count | Max nodes running in parallel. |
Storage
By default everything lives under BIONODULO_DATA_DIR. To use object storage for
artifacts:
| Variable | Description |
|---|---|
BIONODULO_S3_ENDPOINT | S3-compatible endpoint URL |
BIONODULO_S3_BUCKET | Bucket for outputs/artifacts |
BIONODULO_S3_REGION | Region |
BIONODULO_S3_KEY / BIONODULO_S3_SECRET | Credentials |
Node execution backend
| Variable | Default | Description |
|---|---|---|
BIONODULO_RUNNER | docker | docker, local, or slurm/k8s |
BIONODULO_DOCKER_SOCK | /var/run/docker.sock | Path to the container socket. |
For HPC, set BIONODULO_RUNNER=slurm to submit each node as a scheduler job.
Authentication
Self-hosted instances support local accounts out of the box. OIDC/SAML SSO is available for institutional deployments:
| Variable | Description |
|---|---|
BIONODULO_OIDC_ISSUER | OIDC issuer URL |
BIONODULO_OIDC_CLIENT_ID / _SECRET | OIDC client creds |