Create and use signing keys to sign built artifacts
In order to upload a package it must be signed, and in order to install a package published to a Flox Catalog you must configure your system to trust the public key used to sign the package.
By default, packages published to FloxHub-hosted catalogs are signed with the floxhub-1 key, which ships with the Flox installer, so Flox is configured to be able to install user-published packages out of the box.If you installed Flox with Nix instead of the Flox installer — for example with nix profile install, or as part of a nix-darwin or NixOS configuration — your system doesn’t have the floxhub-1 key, and installing a package published to a FloxHub-hosted catalog fails with:
Package 'my-package' is not signed by a trusted key.See https://flox.dev/docs/customer/signing-keys/ for more information.
To fix this, add floxhub-1 to your Nix configuration’s trusted public keys, the same way you would trust any other public key.If you’re using a standalone Nix or Flox-installed Nix setup, add floxhub-1 to the extra-trusted-public-keys line in /etc/nix/nix.conf (append to an existing line rather than adding a second one):
Then restart the Nix daemon.If your system is managed by NixOS or nix-darwin, add it to nix.settings instead, then rebuild and switch into your configuration:
See the generic Nix install instructions for the full configuration examples, including the Flox binary cache key.However, if you’re providing your own Catalog Store, then you must
Create the signing keys
Distribute the private key to users trusted to publish packages
Distribute the public key to users allowed to install those packages
Have those users configure their systems to trust the public key
If you need to use a different signing key (for example, to publish to a different catalog), you can use the --signing-private-key option with the flox publish command.
The option takes precedence over publish.signing_private_key.
The private key is necessary for uploading artifacts, so anyone that needs that capability will need access to the key.
One solution is to put the key in a password manager and grant access to users that need to publish.
Trust a public key to install published artifacts
In order to install a published package you must configure your system to trust the corresponding public key that the artifact was signed with.
This amounts to adding the public key to the list of extra-trusted-public-keys in your Nix configuration.
Add a new trusted key
Nix installed via Flox, or standalone Nix installation
If you installed Nix as part of your Flox installation, you need to edit your /etc/nix/nix.conf to add a new entry to the extra-trusted-public-keys option.
If /etc/nix/nix.conf doesn’t exist, create it.
If the extra-trusted-public-keys option doesn’t exist, create it.
This option is a space-delimited list of trusted public keys.Add the following line, where <key contents> is the contents of the signing public key file and <existing keys> is any keys that were already populated for this option (if it existed):
Note that you do not need quotes around keys in the extra-trusted-public-keys option.
In order for the newly trusted key to take effect, the Nix daemon needs to be restarted.
On Linux the daemon is managed via systemd, so you can restart it with the following command:
sudo systemctl restart nix-daemon
On macOS the Nix daemon is managed via launchd, so you can restart it with the following command (note that you have to run the command twice, this is not a typo):
For systems whose configuration is managed with Nix, you need to add the public key to the list of trusted public keys in your system configuration.
For NixOS, nix-darwin, and home-manager the configuration option is the same:
Once this setting has been edited, rebuild and switch into your new configuration.
Verify that the key is now trusted
Now verify that the daemon has been restarted and picked up the new key.
You can do this by printing out the daemon’s current configuration, and searching for the key that you’ve just added:
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Flox","colors":{"primary":"#8D45FF","light":"#B080FF","dark":"#6F2BFF"},"logo":{"light":"https://mintcdn.com/flox/TGd54292LI04fuY9/logo/light.svg?fit=max\u0026auto=format\u0026n=TGd54292LI04fuY9\u0026q=85\u0026s=a68dffe97384d4c4af5850b2c4ab2d6c","dark":"https://mintcdn.com/flox/TGd54292LI04fuY9/logo/dark.svg?fit=max\u0026auto=format\u0026n=TGd54292LI04fuY9\u0026q=85\u0026s=68e026fe8b554722bc75b10ffd73d7aa"},"favicon":"https://mintcdn.com/flox/TGd54292LI04fuY9/favicon.ico?fit=max\u0026auto=format\u0026n=TGd54292LI04fuY9\u0026q=85\u0026s=07df64850f2e53778fafc31eb4a4cfbc","api":{"playground":{"proxy":false}},"appearance":{"default":"light"},"navbar":{"primary":{"type":"button","label":"Go to FloxHub","href":"https://hub.flox.dev"}},"footer":{"socials":{"github":"https://github.com/flox/flox","x":"https://twitter.com/floxdevelopment","linkedin":"https://www.linkedin.com/company/floxdev","youtube":"https://www.youtube.com/@floxdev","slack":"https://go.flox.dev/slack"}},"seo":{"metatags":{"canonical":"https://flox.dev/docs"}},"fonts":{"heading":{"family":"Geist"},"body":{"family":"Geist"}},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"flox","hasAudioNarration":false,"actualSubdomain":"flox","customDomains":["flox.dev"],"gitSource":{"type":"github","owner":"flox","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"feedback":{"edits":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6afc97107940c4f9a02b3e05","clientVersion":"0.0.4227","searchFilterCounts":[{"language":"default","tag":"Documentation","count":70},{"language":"default","tag":"CLI reference","count":37},{"language":"default","tag":"Concepts","count":27},{"language":"default","tag":"Tutorials","count":17},{"language":"default","tag":"AI agents","count":10},{"language":"default","tag":"Imageless Kubernetes","count":10},{"language":"default","tag":"Languages","count":7},{"language":"default","tag":"Build \u0026 Publish","count":7},{"language":"default","tag":"Packages","count":7},{"language":"default","tag":"Command reference","count":5}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"/docs","hasChatPermissions":false,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[]}
{"page":{"pagePath":"customer/signing-keys","slug":"/customer/signing-keys","pageMetadata":{"title":"Signing keys","description":"Create and use signing keys to sign built artifacts","href":"/customer/signing-keys"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Create and use signing keys to sign built artifacts\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`In order to upload a package it must be signed, and in order to install a package published to a Flox Catalog you must configure your system to trust the public key used to sign the package.\nBy default, packages published to FloxHub-hosted catalogs are signed with the `,_jsx(_components.code,{children:`floxhub-1`}),` key, which ships with the Flox installer, so Flox is configured to be able to install user-published packages out of the box.`]}),`\n`,_jsxs(_components.p,{children:[`If you installed Flox with Nix instead of the Flox installer — for example with `,_jsx(_components.code,{children:`nix profile install`}),`, or as part of a nix-darwin or NixOS configuration — your system doesn’t have the `,_jsx(_components.code,{children:`floxhub-1`}),` key, and installing a package published to a FloxHub-hosted catalog fails with:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`3`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`3`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Package 'my-package' is not signed by a trusted key.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`See https://flox.dev/docs/customer/signing-keys/ for more information.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsxs(_components.p,{children:[`To fix this, add `,_jsx(_components.code,{children:`floxhub-1`}),` to your Nix configuration’s trusted public keys, the same way you would `,_jsx(_components.a,{href:`#trust-a-public-key-to-install-published-artifacts`,children:`trust any other public key`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`If you’re using a standalone Nix or Flox-installed Nix setup, add `,_jsx(_components.code,{children:`floxhub-1`}),` to the `,_jsx(_components.code,{children:`extra-trusted-public-keys`}),` line in `,_jsx(_components.code,{children:`/etc/nix/nix.conf`}),` (append to an existing line rather than adding a second one):`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`extra-trusted-public-keys = \u003cexisting keys> floxhub-1:0QOAlcobcEvq1mqEf4qAYCaWnTTOXpyoRv/PmqfSixM=`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsxs(_components.p,{children:[`Then `,_jsx(_components.a,{href:`#add-a-new-trusted-key`,children:`restart the Nix daemon`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`If your system is managed by NixOS or nix-darwin, add it to `,_jsx(_components.code,{children:`nix.settings`}),` instead, then rebuild and switch into your configuration:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`3`,language:`nix`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`nix`,children:_jsxs(_components.code,{language:`nix`,numberOfLines:`3`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:`nix`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:`settings`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:`extra-trusted-public-keys`}),_jsx(_components.span,{style:{color:`#82071E`,\"--shiki-light-font-style\":`italic`,\"--shiki-dark\":`#F44747`,\"--shiki-dark-font-style\":`inherit`},children:` =`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"floxhub-1:0QOAlcobcEvq1mqEf4qAYCaWnTTOXpyoRv/PmqfSixM=\"`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`]`}),_jsx(_components.span,{style:{color:`#82071E`,\"--shiki-light-font-style\":`italic`,\"--shiki-dark\":`#F44747`,\"--shiki-dark-font-style\":`inherit`},children:`;`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`See the `,_jsx(_components.a,{href:`/install-flox/install#generic-nix`,children:`generic Nix install instructions`}),` for the full configuration examples, including the Flox binary cache key.`]}),`\n`,_jsx(_components.p,{children:`However, if you’re providing your own Catalog Store, then you must`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Create the signing keys`}),`\n`,_jsx(_components.li,{children:`Distribute the private key to users trusted to publish packages`}),`\n`,_jsx(_components.li,{children:`Distribute the public key to users allowed to install those packages`}),`\n`,_jsx(_components.li,{children:`Have those users configure their systems to trust the public key`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`create-a-signing-key-pair`,children:`Create a signing key pair`}),`\n`,_jsxs(_components.p,{children:[`Use the `,_jsx(_components.code,{children:`nix`}),` CLI to generate a private key:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`nix`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` key`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` generate-secret`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --key-name`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` signing-key`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` >`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` signing-key.key`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Then generate a public key from the private key:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`nix`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` key`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` convert-secret-to-public`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` \u003c`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` signing-key.key`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` >`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` signing-key-pub.key`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`sign-packages-to-upload-artifacts`,children:`Sign packages to upload artifacts`}),`\n`,_jsx(_components.p,{children:`Once you’ve generated the key, you can configure Flox to sign the packages\nyou publish with that (private) key:`}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:_jsx(_components.strong,{children:`The path to the private key must be configured with an absolute path for security purposes.`})})}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`flox`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` config`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --set`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` publish.signing_private_key`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"/path/to/signing-key.key\"`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`If you need to use a different signing key (for example, to publish to a different catalog), you can use the `,_jsx(_components.code,{children:`--signing-private-key`}),` option with the `,_jsx(_components.code,{children:`flox publish`}),` command.\nThe option takes precedence over `,_jsx(_components.code,{children:`publish.signing_private_key`}),`.\nThe private key is necessary for uploading artifacts, so anyone that needs that capability will need access to the key.\nOne solution is to put the key in a password manager and grant access to users that need to publish.`]}),`\n`,_jsx(Heading,{level:`2`,id:`trust-a-public-key-to-install-published-artifacts`,children:`Trust a public key to install published artifacts`}),`\n`,_jsxs(_components.p,{children:[`In order to install a published package you must configure your system to trust the corresponding public key that the artifact was signed with.\nThis amounts to adding the public key to the list of `,_jsx(_components.code,{children:`extra-trusted-public-keys`}),` in your Nix configuration.`]}),`\n`,_jsx(Heading,{level:`3`,id:`add-a-new-trusted-key`,children:`Add a new trusted key`}),`\n`,_jsx(Heading,{level:`4`,id:`nix-installed-via-flox-or-standalone-nix-installation`,children:`Nix installed via Flox, or standalone Nix installation`}),`\n`,_jsxs(_components.p,{children:[`If you installed Nix as part of your Flox installation, you need to edit your `,_jsx(_components.code,{children:`/etc/nix/nix.conf`}),` to add a new entry to the `,_jsx(_components.code,{children:`extra-trusted-public-keys`}),` option.\nIf `,_jsx(_components.code,{children:`/etc/nix/nix.conf`}),` doesn’t exist, create it.\nIf the `,_jsx(_components.code,{children:`extra-trusted-public-keys`}),` option doesn’t exist, create it.\nThis option is a space-delimited list of trusted public keys.`]}),`\n`,_jsxs(_components.p,{children:[`Add the following line, where `,_jsx(_components.code,{children:`\u003ckey contents>`}),` is the contents of the signing public key file and `,_jsx(_components.code,{children:`\u003cexisting keys>`}),` is any keys that were already populated for this option (if it existed):`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`extra-trusted-public-keys = \u003cexisting keys> \u003ckey contents>`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsxs(_components.p,{children:[`Note that you do not need quotes around keys in the `,_jsx(_components.code,{children:`extra-trusted-public-keys`}),` option.\nIn order for the newly trusted key to take effect, the Nix daemon needs to be restarted.\nOn Linux the daemon is managed via `,_jsx(_components.code,{children:`systemd`}),`, so you can restart it with the following command:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`sudo`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` systemctl`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` restart`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` nix-daemon`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`On macOS the Nix daemon is managed via `,_jsx(_components.code,{children:`launchd`}),`, so you can restart it with the following command (note that you have to run the command twice, this is not a typo):`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`sudo`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` launchctl`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` kickstart`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -k`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` system/org.nixos.nix-daemon`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`;`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`sudo`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` launchctl`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` kickstart`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -k`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` system/org.nixos.nix-daemon`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`4`,id:`nixos-nix-darwin-or-home-manager`,children:`NixOS, nix-darwin, or home-manager`}),`\n`,_jsxs(_components.p,{children:[`For systems whose configuration is managed with Nix, you need to add the public key to the list of trusted public keys in your system configuration.\nFor NixOS, `,_jsx(_components.code,{children:`nix-darwin`}),`, and `,_jsx(_components.code,{children:`home-manager`}),` the configuration option is the same:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`3`,language:`nix`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`nix`,children:_jsxs(_components.code,{language:`nix`,numberOfLines:`3`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:`nix`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:`settings`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:`extra-trusted-public-keys`}),_jsx(_components.span,{style:{color:`#82071E`,\"--shiki-light-font-style\":`italic`,\"--shiki-dark\":`#F44747`,\"--shiki-dark-font-style\":`inherit`},children:` =`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"\u003ckey contents>\"`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`]`}),_jsx(_components.span,{style:{color:`#82071E`,\"--shiki-light-font-style\":`italic`,\"--shiki-dark\":`#F44747`,\"--shiki-dark-font-style\":`inherit`},children:`;`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Once this setting has been edited, rebuild and switch into your new configuration.`}),`\n`,_jsx(Heading,{level:`3`,id:`verify-that-the-key-is-now-trusted`,children:`Verify that the key is now trusted`}),`\n`,_jsx(_components.p,{children:`Now verify that the daemon has been restarted and picked up the new key.\nYou can do this by printing out the daemon’s current configuration, and searching for the key that you’ve just added:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`nix`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` config`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` show`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` |`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:` grep`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` trusted-public-key`})]}),`\n`]})})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Signing keys","description":"Create and use signing keys to sign built artifacts","href":"/customer/signing-keys"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Create a signing key pair","slug":"create-a-signing-key-pair","depth":2,"children":[]},{"title":"Sign packages to upload artifacts","slug":"sign-packages-to-upload-artifacts","depth":2,"children":[]},{"title":"Trust a public key to install published artifacts","slug":"trust-a-public-key-to-install-published-artifacts","depth":2,"children":[{"title":"Add a new trusted key","slug":"add-a-new-trusted-key","depth":3,"children":[]},{"title":"Nix installed via Flox, or standalone Nix installation","slug":"nix-installed-via-flox-or-standalone-nix-installation","depth":4,"children":[]},{"title":"NixOS, nix-darwin, or home-manager","slug":"nixos-nix-darwin-or-home-manager","depth":4,"children":[]},{"title":"Verify that the key is now trusted","slug":"verify-that-the-key-is-now-trusted","depth":3,"children":[]}]}],"codeExamples":{}},"jsLinks":["/docs/_mintlify/custom/flox/d4dc44fc16caa8e0/amplitude.js","/docs/_mintlify/custom/flox/7a15237175dc5cb4/hubspot.js","/docs/_mintlify/custom/flox/2c0cb21cf2c0757c/plausible.js"],"subdomain":"flox","siteName":"Flox","title":"Signing keys - Flox","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-29T20:24:45.999Z","originalFileLocation":"customer/signing-keys.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"light\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Create and use signing keys to sign built artifacts\">\u003cmeta data-mint-head name=\"application-name\" content=\"Flox\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/flox/GZA6Gh0WLJjYFtuZ/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/flox/GZA6Gh0WLJjYFtuZ/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/flox/GZA6Gh0WLJjYFtuZ/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/flox/GZA6Gh0WLJjYFtuZ/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/flox/GZA6Gh0WLJjYFtuZ/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/flox/GZA6Gh0WLJjYFtuZ/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/flox/GZA6Gh0WLJjYFtuZ/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/flox/GZA6Gh0WLJjYFtuZ/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/flox/GZA6Gh0WLJjYFtuZ/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Signing keys - Flox\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create and use signing keys to sign built artifacts\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Flox\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://flox.dev/docs/customer/signing-keys\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://flox.mintlify.site/docs/_mintlify/api/og/v2?division=Customer\u0026amp;title=Signing+keys\u0026amp;description=Create+and+use+signing+keys+to+sign+built+artifacts\u0026amp;theme=6dcec81f26a883a3feaafa26\u0026amp;signature=7b35322b031fc3b0b6140b081173978f51a2a0c6411e5d6eeb5ccb6d181b0e87\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Signing keys - Flox\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create and use signing keys to sign built artifacts\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://flox.mintlify.site/docs/_mintlify/api/og/v2?division=Customer\u0026amp;title=Signing+keys\u0026amp;description=Create+and+use+signing+keys+to+sign+built+artifacts\u0026amp;theme=6dcec81f26a883a3feaafa26\u0026amp;signature=7b35322b031fc3b0b6140b081173978f51a2a0c6411e5d6eeb5ccb6d181b0e87\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/flox/GZA6Gh0WLJjYFtuZ/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Flox\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#8D45FF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://flox.dev/docs/customer/signing-keys\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/customer/signing-keys.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://flox.dev/#organization\",\"name\":\"Flox\",\"url\":\"https://flox.dev\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/flox/TGd54292LI04fuY9/logo/light.svg?fit=max\u0026auto=format\u0026n=TGd54292LI04fuY9\u0026q=85\u0026s=a68dffe97384d4c4af5850b2c4ab2d6c\"}},{\"@type\":\"WebSite\",\"@id\":\"https://flox.dev/docs#website\",\"name\":\"Flox\",\"url\":\"https://flox.dev/docs\",\"publisher\":{\"@id\":\"https://flox.dev/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://flox.dev/docs/customer/signing-keys#webpage\",\"url\":\"https://flox.dev/docs/customer/signing-keys\",\"name\":\"Signing keys\",\"description\":\"Create and use signing keys to sign built artifacts\",\"dateModified\":\"2026-09-29T20:24:45.999Z\",\"isPartOf\":{\"@id\":\"https://flox.dev/docs#website\"},\"breadcrumb\":{\"@id\":\"https://flox.dev/docs/customer/signing-keys#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://flox.dev/docs/customer/signing-keys#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Customer\",\"item\":\"https://flox.dev/docs/customer/catalog-store\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Signing keys\",\"item\":\"https://flox.dev/docs/customer/signing-keys\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://flox.dev/docs/customer/signing-keys#article\",\"headline\":\"Signing keys\",\"name\":\"Signing keys\",\"description\":\"Create and use signing keys to sign built artifacts\",\"url\":\"https://flox.dev/docs/customer/signing-keys\",\"mainEntityOfPage\":{\"@id\":\"https://flox.dev/docs/customer/signing-keys#webpage\"},\"dateModified\":\"2026-09-29T20:24:45.999Z\",\"publisher\":{\"@id\":\"https://flox.dev/#organization\"},\"isPartOf\":{\"@id\":\"https://flox.dev/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Flox\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Flox\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/customer/signing-keys.md","siteName":"Flox","nav":{"global":null,"tabs":[{"tab":"Documentation","groups":[{"group":"Introduction","pages":[{"title":"Introduction","href":""}]},{"group":"Install Flox","pages":[{"title":"Install Flox","href":"/install-flox/install"},{"title":"Uninstall Flox","href":"/install-flox/uninstall"},{"title":"Troubleshooting installation","href":"/install-flox/troubleshooting"},{"title":"Extensions","href":"/install-flox/ide-extensions"}]},{"group":"Quickstart","pages":[{"title":"Flox in 5 minutes","href":"/flox-5-minutes"}]},{"group":"Tutorials","pages":[{"title":"Creating environments","href":"/tutorials/creating-environments"},{"title":"The default environment","href":"/tutorials/default-environment"},{"title":"Example default environments","href":"/tutorials/default-environment-examples"},{"title":"Sharing your environments","href":"/tutorials/sharing-environments"},{"title":"Layering multiple environments","href":"/tutorials/layering-multiple-environments"},{"title":"Customizing the shell environment","href":"/tutorials/customizing-environments"},{"title":"Designing cross-platform environments","href":"/tutorials/multi-arch-environments"},{"title":"Build and publish packages","href":"/tutorials/build-and-publish"},{"title":"Using a newer version of a package","href":"/tutorials/overriding-packages"},{"title":"Running Flox in CI/CD","href":"/tutorials/ci-cd"},{"title":"Reusing and combining developer environments","href":"/tutorials/composition"},{"title":"Selecting package outputs","href":"/tutorials/package-outputs"},{"title":"Flox + CUDA tutorial","href":"/tutorials/cuda"},{"title":"Flox and systemd","href":"/tutorials/flox-and-systemd"},{"title":"Installing Flox from its repository on Debian and Red Hat","href":"/tutorials/installing-from-repo"},{"group":"Migration guides","pages":[{"title":"Homebrew","href":"/tutorials/migrations/homebrew"},{"title":"Node Version Manager (nvm)","href":"/tutorials/migrations/nvm"}]}]},{"group":"Imageless Kubernetes","pages":[{"title":"Imageless Kubernetes Introduction","href":"/imageless-kubernetes/intro"},{"title":"Tech","href":"/imageless-kubernetes/tech"},{"group":"Installation","pages":[{"title":"Amazon EKS","href":"/imageless-kubernetes/install/eks"},{"title":"Self-managed Kubernetes","href":"/imageless-kubernetes/install/self-managed"},{"title":"Troubleshooting","href":"/imageless-kubernetes/install/troubleshooting"},{"title":"Upgrading","href":"/imageless-kubernetes/install/upgrading"},{"title":"Uninstall","href":"/imageless-kubernetes/install/uninstall"}]},{"group":"Examples","pages":[{"title":"GitLab CI","href":"/imageless-kubernetes/examples/gitlab-ci"},{"title":"Web server with Redis on kind","href":"/imageless-kubernetes/examples/kind-demo"}]},{"title":"Configuration","href":"/imageless-kubernetes/config"}]},{"group":"Concepts","pages":[{"title":"What is a Flox environment?","href":"/concepts/environments"},{"title":"Activating environments","href":"/concepts/activation"},{"title":"Auto-activation","href":"/concepts/auto-activation"},{"title":"Compatibility policy","href":"/concepts/compatibility"},{"title":"What is FloxHub?","href":"/concepts/floxhub"},{"title":"FloxHub environments","href":"/concepts/floxhub-environments"},{"title":"What is a generation?","href":"/concepts/generations"},{"title":"What is the Flox Catalog?","href":"/concepts/packages-and-catalog"},{"title":"Package Groups","href":"/concepts/package-groups"},{"title":"What is the Base Catalog?","href":"/concepts/base-catalog"},{"title":"CUDA packages in the Flox Catalog and binary cache","href":"/concepts/cuda-catalog-and-cache"},{"title":"Services","href":"/concepts/services"},{"title":"Composing environments","href":"/concepts/composition"},{"title":"Authentication","href":"/concepts/authentication"},{"title":"What Flox collects","href":"/concepts/data-collection"},{"title":"Understanding Organizations in FloxHub","href":"/concepts/organizations"},{"title":"Enterprise SSO","href":"/concepts/enterprise-sso"},{"title":"Service accounts","href":"/concepts/service-accounts"},{"title":"Personal access tokens","href":"/concepts/personal-access-tokens"},{"title":"Builds","href":"/concepts/builds"},{"title":"Manifest Builds","href":"/concepts/manifest-builds"},{"title":"Nix expression builds","href":"/concepts/nix-expression-builds"},{"title":"Catalog imports","href":"/concepts/catalog-imports"},{"title":"Publishing","href":"/concepts/publishing"},{"title":"Secrets management","href":"/concepts/secrets-management"},{"title":"Plugins","href":"/concepts/plugins"},{"title":"Flox vs. container workflows","href":"/concepts/flox-vs-containers"}]},{"group":"Languages","pages":[{"title":"C/C++","href":"/languages/c"},{"title":"Go","href":"/languages/go"},{"title":"JVM","href":"/languages/jvm"},{"title":"Node.js","href":"/languages/nodejs"},{"title":"Python","href":"/languages/python"},{"title":"Ruby","href":"/languages/ruby"},{"title":"Rust","href":"/languages/rust"}]},{"group":"Customer","pages":[{"title":"Catalog Store","href":"/customer/catalog-store"},{"title":"Known issues","description":"Known Flox limitations and their workarounds, including false-positive build dependencies","href":"/customer/known-issues"},{"title":"Signing keys","href":"/customer/signing-keys"}]}]},{"tab":"CLI reference","pages":[{"title":"CLI reference","href":"/man/flox"}]},{"tab":"AI agents","pages":[{"title":"AI agents","href":"/ai-agents/quickstart"}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog"}]}]},"basePath":"","title":"Signing keys - Flox","deploymentId":"dpl_2MqcLy8smQrrovUehgcZEsoo1tJX","buildId":"dpl_2MqcLy8smQrrovUehgcZEsoo1tJX","dynamics":[],"chunks":[]}