<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>Server Configuration on Nebula Commander</title><link>https://nebulacommander.com/docs/configuration/</link><description>Recent content in Server Configuration on Nebula Commander</description><generator>Hugo</generator><language>en</language><atom:link href="https://nebulacommander.com/docs/configuration/index.xml" rel="self" type="application/rss+xml"/><item><title>Environment Variables</title><link>https://nebulacommander.com/docs/configuration/environment/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://nebulacommander.com/docs/configuration/environment/</guid><description>&lt;p&gt;All backend settings use the &lt;code&gt;NEBULA_COMMANDER_&lt;/code&gt; prefix. Set them in the environment or in a file (e.g. &lt;code&gt;docker/env.d/backend&lt;/code&gt;). Optional values can be omitted; defaults apply.&lt;/p&gt;
&lt;h2 id="application"&gt;Application&lt;/h2&gt;
&lt;table&gt;
 &lt;thead&gt;
 &lt;tr&gt;
 &lt;th&gt;Variable&lt;/th&gt;
 &lt;th&gt;Description&lt;/th&gt;
 &lt;th&gt;Default&lt;/th&gt;
 &lt;/tr&gt;
 &lt;/thead&gt;
 &lt;tbody&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;NEBULA_COMMANDER_DEBUG&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;Enable debug mode (enables dev-token endpoint; do not use in production)&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;false&lt;/code&gt;&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;NEBULA_COMMANDER_API_DOCS_ENABLED&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;From v0.9.0. Serve the interactive API docs at &lt;code&gt;/api/docs&lt;/code&gt; (Swagger UI) and &lt;code&gt;/api/redoc&lt;/code&gt;, with the schema at &lt;code&gt;/api/openapi.json&lt;/code&gt;. Every API endpoint still requires authentication either way; set to &lt;code&gt;false&lt;/code&gt; to hide the endpoint list and the server version from anyone who can reach the server. NixOS: &lt;code&gt;services.nebula-commander.apiDocs&lt;/code&gt;.&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;true&lt;/code&gt;&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;NEBULA_COMMANDER_UPDATE_CHECK_ENABLED&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;Check GitHub for a newer release, shown as a notification in the About screen. Set to &lt;code&gt;false&lt;/code&gt; to disable all outbound calls to github.com (air-gapped/privacy-conscious deployments).&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;true&lt;/code&gt;&lt;/td&gt;
 &lt;/tr&gt;
 &lt;/tbody&gt;
&lt;/table&gt;
&lt;h2 id="database"&gt;Database&lt;/h2&gt;
&lt;table&gt;
 &lt;thead&gt;
 &lt;tr&gt;
 &lt;th&gt;Variable&lt;/th&gt;
 &lt;th&gt;Description&lt;/th&gt;
 &lt;th&gt;Default&lt;/th&gt;
 &lt;/tr&gt;
 &lt;/thead&gt;
 &lt;tbody&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;NEBULA_COMMANDER_DATABASE_URL&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;Database URL (SQLite: use four slashes for absolute path, e.g. &lt;code&gt;sqlite+aiosqlite:////var/lib/nebula-commander/db.sqlite&lt;/code&gt;)&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;sqlite+aiosqlite:////var/lib/nebula-commander/db.sqlite&lt;/code&gt;&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;NEBULA_COMMANDER_DATABASE_PATH&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;Override for SQLite path&lt;/td&gt;
 &lt;td&gt;—&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;NEBULA_COMMANDER_CERT_STORE_PATH&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;Directory for CA and host certificates&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;/var/lib/nebula-commander/certs&lt;/code&gt;&lt;/td&gt;
 &lt;/tr&gt;
 &lt;/tbody&gt;
&lt;/table&gt;
&lt;h2 id="encryption-at-rest"&gt;Encryption at rest&lt;/h2&gt;
&lt;p&gt;&lt;strong&gt;Required.&lt;/strong&gt; The backend refuses to boot if this is left at a placeholder/unset
value — unlike most settings here, there&amp;rsquo;s no insecure-but-working default.&lt;/p&gt;</description></item><item><title>OIDC Authentication</title><link>https://nebulacommander.com/docs/configuration/oidc/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://nebulacommander.com/docs/configuration/oidc/</guid><description>&lt;p&gt;Nebula Commander can use OpenID Connect (OIDC) for login. Keycloak is supported with a pre-configured setup; other OIDC providers (Authentik, Auth0, etc.) work with the same environment variables.&lt;/p&gt;
&lt;h2 id="required-variables"&gt;Required variables&lt;/h2&gt;
&lt;p&gt;Set these in &lt;code&gt;env.d/backend&lt;/code&gt; (Docker) or in the backend environment:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;&lt;code&gt;NEBULA_COMMANDER_PUBLIC_URL&lt;/code&gt;&lt;/strong&gt; – URL where users reach the app (FQDN or host:port). The redirect URI is derived as PUBLIC_URL + &lt;code&gt;/api/auth/callback&lt;/code&gt; if you do not set &lt;code&gt;OIDC_REDIRECT_URI&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;&lt;code&gt;NEBULA_COMMANDER_OIDC_ISSUER_URL&lt;/code&gt;&lt;/strong&gt; – Issuer URL used by the &lt;strong&gt;backend&lt;/strong&gt; to talk to the provider. Inside Docker use the container name and container port (e.g. &lt;code&gt;http://keycloak:8080/realms/nebula-commander&lt;/code&gt;). Do not use the host-mapped port here.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;&lt;code&gt;NEBULA_COMMANDER_OIDC_PUBLIC_ISSUER_URL&lt;/code&gt;&lt;/strong&gt; – Issuer URL as seen by the &lt;strong&gt;browser&lt;/strong&gt; (FQDN or host:port). Use the same URL users would use to open the provider’s login page.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;&lt;code&gt;NEBULA_COMMANDER_OIDC_CLIENT_ID&lt;/code&gt;&lt;/strong&gt; – OIDC client ID (e.g. &lt;code&gt;nebula-commander&lt;/code&gt;).&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;&lt;code&gt;NEBULA_COMMANDER_OIDC_CLIENT_SECRET&lt;/code&gt;&lt;/strong&gt; – Client secret from the provider. Prefer &lt;code&gt;NEBULA_COMMANDER_OIDC_CLIENT_SECRET_FILE&lt;/code&gt; in production.&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;Optional: &lt;strong&gt;&lt;code&gt;NEBULA_COMMANDER_OIDC_REDIRECT_URI&lt;/code&gt;&lt;/strong&gt; – Override only if you need a callback URL different from PUBLIC_URL + &lt;code&gt;/api/auth/callback&lt;/code&gt;.&lt;/p&gt;</description></item></channel></rss>