docs/Lix/Command-Reference/New-CLI/nix3-copy/index.html

4602 lines
79 KiB
HTML

<!doctype html>
<html lang="en" class="no-js">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<meta name="description" content="Aux Documentation">
<meta name="author" content="Nixpkgs Aux, and Lix Contributors">
<link rel="canonical" href="https://docs.auxolotl.org/Lix/Command-Reference/New-CLI/nix3-copy/">
<link rel="prev" href="../nix3-config/">
<link rel="next" href="../nix3-daemon/">
<link rel="icon" href="../../../../assets/aux-logo.svg">
<meta name="generator" content="mkdocs-1.6.0, mkdocs-material-9.5.29">
<title>nix copy - Aux Docs</title>
<link rel="stylesheet" href="../../../../assets/stylesheets/main.76a95c52.min.css">
<link rel="stylesheet" href="../../../../assets/stylesheets/palette.06af60db.min.css">
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
<link rel="stylesheet" href="https://fonts.bunny.net/css?family=IBM+Plex+Sans:300,300i,400,400i,700,700i%7CIBM+Plex+Mono:400,400i,700,700i&display=fallback">
<style>:root{--md-text-font:"IBM Plex Sans";--md-code-font:"IBM Plex Mono"}</style>
<script>__md_scope=new URL("../../../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
<meta property="og:type" content="website" >
<meta property="og:title" content="`nix copy` - Aux Docs" >
<meta property="og:description" content="Aux Documentation" >
<meta property="og:image" content="https://docs.auxolotl.org/assets/images/social/Lix/Command-Reference/New-CLI/nix3-copy.png" >
<meta property="og:image:type" content="image/png" >
<meta property="og:image:width" content="1200" >
<meta property="og:image:height" content="630" >
<meta property="og:url" content="https://docs.auxolotl.org/Lix/Command-Reference/New-CLI/nix3-copy/" >
<meta name="twitter:card" content="summary_large_image" >
<meta name="twitter:title" content="`nix copy` - Aux Docs" >
<meta name="twitter:description" content="Aux Documentation" >
<meta name="twitter:image" content="https://docs.auxolotl.org/assets/images/social/Lix/Command-Reference/New-CLI/nix3-copy.png" >
</head>
<body dir="ltr" data-md-color-scheme="default" data-md-color-primary="indigo" data-md-color-accent="blue">
<input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
<input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
<label class="md-overlay" for="__drawer"></label>
<div data-md-component="skip">
<a href="#nix-copy" class="md-skip">
Skip to content
</a>
</div>
<div data-md-component="announce">
</div>
<header class="md-header" data-md-component="header">
<nav class="md-header__inner md-grid" aria-label="Header">
<a href="../../../.." title="Aux Docs" class="md-header__button md-logo" aria-label="Aux Docs" data-md-component="logo">
<img src="../../../../assets/aux-logo.svg" alt="logo">
</a>
<label class="md-header__button md-icon" for="__drawer">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
</label>
<div class="md-header__title" data-md-component="header-title">
<div class="md-header__ellipsis">
<div class="md-header__topic">
<span class="md-ellipsis">
Aux Docs
</span>
</div>
<div class="md-header__topic" data-md-component="header-topic">
<span class="md-ellipsis">
nix copy
</span>
</div>
</div>
</div>
<form class="md-header__option" data-md-component="palette">
<input class="md-option" data-md-color-media="(prefers-color-scheme: light)" data-md-color-scheme="default" data-md-color-primary="indigo" data-md-color-accent="blue" aria-label="Dark Mode" type="radio" name="__palette" id="__palette_0">
<label class="md-header__button md-icon" title="Dark Mode" for="__palette_1" hidden>
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="m17.75 4.09-2.53 1.94.91 3.06-2.63-1.81-2.63 1.81.91-3.06-2.53-1.94L12.44 4l1.06-3 1.06 3 3.19.09m3.5 6.91-1.64 1.25.59 1.98-1.7-1.17-1.7 1.17.59-1.98L15.75 11l2.06-.05L18.5 9l.69 1.95 2.06.05m-2.28 4.95c.83-.08 1.72 1.1 1.19 1.85-.32.45-.66.87-1.08 1.27C15.17 23 8.84 23 4.94 19.07c-3.91-3.9-3.91-10.24 0-14.14.4-.4.82-.76 1.27-1.08.75-.53 1.93.36 1.85 1.19-.27 2.86.69 5.83 2.89 8.02a9.96 9.96 0 0 0 8.02 2.89m-1.64 2.02a12.08 12.08 0 0 1-7.8-3.47c-2.17-2.19-3.33-5-3.49-7.82-2.81 3.14-2.7 7.96.31 10.98 3.02 3.01 7.84 3.12 10.98.31Z"/></svg>
</label>
<input class="md-option" data-md-color-media="(prefers-color-scheme: dark)" data-md-color-scheme="slate" data-md-color-primary="indigo" data-md-color-accent="blue" aria-label="Light Mode" type="radio" name="__palette" id="__palette_1">
<label class="md-header__button md-icon" title="Light Mode" for="__palette_0" hidden>
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 7a5 5 0 0 1 5 5 5 5 0 0 1-5 5 5 5 0 0 1-5-5 5 5 0 0 1 5-5m0 2a3 3 0 0 0-3 3 3 3 0 0 0 3 3 3 3 0 0 0 3-3 3 3 0 0 0-3-3m0-7 2.39 3.42C13.65 5.15 12.84 5 12 5c-.84 0-1.65.15-2.39.42L12 2M3.34 7l4.16-.35A7.2 7.2 0 0 0 5.94 8.5c-.44.74-.69 1.5-.83 2.29L3.34 7m.02 10 1.76-3.77a7.131 7.131 0 0 0 2.38 4.14L3.36 17M20.65 7l-1.77 3.79a7.023 7.023 0 0 0-2.38-4.15l4.15.36m-.01 10-4.14.36c.59-.51 1.12-1.14 1.54-1.86.42-.73.69-1.5.83-2.29L20.64 17M12 22l-2.41-3.44c.74.27 1.55.44 2.41.44.82 0 1.63-.17 2.37-.44L12 22Z"/></svg>
</label>
</form>
<script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
<label class="md-header__button md-icon" for="__search">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
</label>
<div class="md-search" data-md-component="search" role="dialog">
<label class="md-search__overlay" for="__search"></label>
<div class="md-search__inner" role="search">
<form class="md-search__form" name="search">
<input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
<label class="md-search__icon md-icon" for="__search">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
</label>
<nav class="md-search__options" aria-label="Search">
<button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
</button>
</nav>
</form>
<div class="md-search__output">
<div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
<div class="md-search-result" data-md-component="search-result">
<div class="md-search-result__meta">
Initializing search
</div>
<ol class="md-search-result__list" role="presentation"></ol>
</div>
</div>
</div>
</div>
</div>
<div class="md-header__source">
<a href="https://git.auxolotl.org/auxolotl/docs" title="Go to repository" class="md-source" data-md-component="source">
<div class="md-source__icon md-icon">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M16.777 0a2.9 2.9 0 1 1-2.529 4.322H12.91a4.266 4.266 0 0 0-4.265 4.195v2.118a7.076 7.076 0 0 1 4.147-1.42l.118-.002h1.338a2.9 2.9 0 0 1 5.43 1.422 2.9 2.9 0 0 1-5.43 1.422H12.91a4.266 4.266 0 0 0-4.265 4.195v2.319A2.9 2.9 0 0 1 7.222 24 2.9 2.9 0 0 1 5.8 18.57V8.589a7.109 7.109 0 0 1 6.991-7.108l.118-.001h1.338A2.9 2.9 0 0 1 16.778 0ZM7.223 19.905a1.194 1.194 0 1 0 0 2.389 1.194 1.194 0 0 0 0-2.389Zm9.554-10.464a1.194 1.194 0 1 0 0 2.389 1.194 1.194 0 0 0 0-2.39Zm0-7.735a1.194 1.194 0 1 0 0 2.389 1.194 1.194 0 0 0 0-2.389Z"/></svg>
</div>
<div class="md-source__repository">
auxolotl/docs
</div>
</a>
</div>
</nav>
</header>
<div class="md-container" data-md-component="container">
<nav class="md-tabs" aria-label="Tabs" data-md-component="tabs">
<div class="md-grid">
<ul class="md-tabs__list">
<li class="md-tabs__item">
<a href="../../../.." class="md-tabs__link">
Aux Documentation Hub
</a>
</li>
<li class="md-tabs__item">
<a href="../../../../TODO/" class="md-tabs__link">
TODO
</a>
</li>
<li class="md-tabs__item">
<a href="../../../../Aux/" class="md-tabs__link">
Aux
</a>
</li>
<li class="md-tabs__item md-tabs__item--active">
<a href="../../../" class="md-tabs__link">
Lix
</a>
</li>
<li class="md-tabs__item">
<a href="../../../../NixOS/appstream/" class="md-tabs__link">
NixOS
</a>
</li>
<li class="md-tabs__item">
<a href="../../../../Nixpkgs/" class="md-tabs__link">
Nixpkgs
</a>
</li>
</ul>
</div>
</nav>
<main class="md-main" data-md-component="main">
<div class="md-main__inner md-grid">
<div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
<div class="md-sidebar__scrollwrap">
<div class="md-sidebar__inner">
<nav class="md-nav md-nav--primary md-nav--lifted" aria-label="Navigation" data-md-level="0">
<label class="md-nav__title" for="__drawer">
<a href="../../../.." title="Aux Docs" class="md-nav__button md-logo" aria-label="Aux Docs" data-md-component="logo">
<img src="../../../../assets/aux-logo.svg" alt="logo">
</a>
Aux Docs
</label>
<div class="md-nav__source">
<a href="https://git.auxolotl.org/auxolotl/docs" title="Go to repository" class="md-source" data-md-component="source">
<div class="md-source__icon md-icon">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M16.777 0a2.9 2.9 0 1 1-2.529 4.322H12.91a4.266 4.266 0 0 0-4.265 4.195v2.118a7.076 7.076 0 0 1 4.147-1.42l.118-.002h1.338a2.9 2.9 0 0 1 5.43 1.422 2.9 2.9 0 0 1-5.43 1.422H12.91a4.266 4.266 0 0 0-4.265 4.195v2.319A2.9 2.9 0 0 1 7.222 24 2.9 2.9 0 0 1 5.8 18.57V8.589a7.109 7.109 0 0 1 6.991-7.108l.118-.001h1.338A2.9 2.9 0 0 1 16.778 0ZM7.223 19.905a1.194 1.194 0 1 0 0 2.389 1.194 1.194 0 0 0 0-2.389Zm9.554-10.464a1.194 1.194 0 1 0 0 2.389 1.194 1.194 0 0 0 0-2.39Zm0-7.735a1.194 1.194 0 1 0 0 2.389 1.194 1.194 0 0 0 0-2.389Z"/></svg>
</div>
<div class="md-source__repository">
auxolotl/docs
</div>
</a>
</div>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="../../../.." class="md-nav__link">
<span class="md-ellipsis">
Aux Documentation Hub
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../../../TODO/" class="md-nav__link">
<span class="md-ellipsis">
TODO
</span>
</a>
</li>
<li class="md-nav__item md-nav__item--pruned md-nav__item--nested">
<a href="../../../../Aux/" class="md-nav__link">
<span class="md-ellipsis">
Aux
</span>
<span class="md-nav__icon md-icon"></span>
</a>
</li>
<li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested">
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" checked>
<div class="md-nav__link md-nav__container">
<a href="../../../" class="md-nav__link ">
<span class="md-ellipsis">
Lix
</span>
</a>
<label class="md-nav__link " for="__nav_4" id="__nav_4_label" tabindex="">
<span class="md-nav__icon md-icon"></span>
</label>
</div>
<nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="true">
<label class="md-nav__title" for="__nav_4">
<span class="md-nav__icon md-icon"></span>
Lix
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="../../../glossary/" class="md-nav__link">
<span class="md-ellipsis">
Glossary
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../../quick-start/" class="md-nav__link">
<span class="md-ellipsis">
Quick Start
</span>
</a>
</li>
<li class="md-nav__item md-nav__item--pruned md-nav__item--nested">
<a href="../../../Advanced-Topics/" class="md-nav__link">
<span class="md-ellipsis">
Advanced Topics
</span>
<span class="md-nav__icon md-icon"></span>
</a>
</li>
<li class="md-nav__item md-nav__item--active md-nav__item--nested">
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4_5" checked>
<div class="md-nav__link md-nav__container">
<a href="../../" class="md-nav__link ">
<span class="md-ellipsis">
Command Reference
</span>
</a>
<label class="md-nav__link " for="__nav_4_5" id="__nav_4_5_label" tabindex="0">
<span class="md-nav__icon md-icon"></span>
</label>
</div>
<nav class="md-nav" data-md-level="2" aria-labelledby="__nav_4_5_label" aria-expanded="true">
<label class="md-nav__title" for="__nav_4_5">
<span class="md-nav__icon md-icon"></span>
Command Reference
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="../../conf-file/" class="md-nav__link">
<span class="md-ellipsis">
nix.conf
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../env-common/" class="md-nav__link">
<span class="md-ellipsis">
Common Environment Variables
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../experimental-commands/" class="md-nav__link">
<span class="md-ellipsis">
Experimental Commands
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../main-commands/" class="md-nav__link">
<span class="md-ellipsis">
Main Commands
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../nix-build/" class="md-nav__link">
<span class="md-ellipsis">
nix-build
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../nix-channel/" class="md-nav__link">
<span class="md-ellipsis">
nix-channel
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../nix-collect-garbage/" class="md-nav__link">
<span class="md-ellipsis">
nix-collect-garbage
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../nix-copy-closure/" class="md-nav__link">
<span class="md-ellipsis">
nix-copy-closure
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../nix-daemon/" class="md-nav__link">
<span class="md-ellipsis">
nix-daemon
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../nix-hash/" class="md-nav__link">
<span class="md-ellipsis">
nix-hash
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../nix-instantiate/" class="md-nav__link">
<span class="md-ellipsis">
nix-instantiate
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../nix-prefetch-url/" class="md-nav__link">
<span class="md-ellipsis">
nix-prefetch-url
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../nix-shell/" class="md-nav__link">
<span class="md-ellipsis">
nix-shell
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../opt-common/" class="md-nav__link">
<span class="md-ellipsis">
Common Options
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../utilities/" class="md-nav__link">
<span class="md-ellipsis">
Utilities
</span>
</a>
</li>
<li class="md-nav__item md-nav__item--active md-nav__item--nested">
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4_5_17" checked>
<label class="md-nav__link" for="__nav_4_5_17" id="__nav_4_5_17_label" tabindex="0">
<span class="md-ellipsis">
New CLI
</span>
<span class="md-nav__icon md-icon"></span>
</label>
<nav class="md-nav" data-md-level="3" aria-labelledby="__nav_4_5_17_label" aria-expanded="true">
<label class="md-nav__title" for="__nav_4_5_17">
<span class="md-nav__icon md-icon"></span>
New CLI
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="../nix/" class="md-nav__link">
<span class="md-ellipsis">
nix
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-build/" class="md-nav__link">
<span class="md-ellipsis">
nix build
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-bundle/" class="md-nav__link">
<span class="md-ellipsis">
nix bundle
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-config-show/" class="md-nav__link">
<span class="md-ellipsis">
nix config show
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-config/" class="md-nav__link">
<span class="md-ellipsis">
nix config
</span>
</a>
</li>
<li class="md-nav__item md-nav__item--active">
<input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
<label class="md-nav__link md-nav__link--active" for="__toc">
<span class="md-ellipsis">
nix copy
</span>
<span class="md-nav__icon md-icon"></span>
</label>
<a href="./" class="md-nav__link md-nav__link--active">
<span class="md-ellipsis">
nix copy
</span>
</a>
<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
<label class="md-nav__title" for="__toc">
<span class="md-nav__icon md-icon"></span>
Table of contents
</label>
<ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
<li class="md-nav__item">
<a href="#synopsis" class="md-nav__link">
<span class="md-ellipsis">
Synopsis
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#examples" class="md-nav__link">
<span class="md-ellipsis">
Examples
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#description" class="md-nav__link">
<span class="md-ellipsis">
Description
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#options" class="md-nav__link">
<span class="md-ellipsis">
Options
</span>
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="../nix3-daemon/" class="md-nav__link">
<span class="md-ellipsis">
nix daemon
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-derivation-add/" class="md-nav__link">
<span class="md-ellipsis">
nix derivation add
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-derivation-show/" class="md-nav__link">
<span class="md-ellipsis">
nix derivation show
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-derivation/" class="md-nav__link">
<span class="md-ellipsis">
nix derivation
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-develop/" class="md-nav__link">
<span class="md-ellipsis">
nix develop
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-doctor/" class="md-nav__link">
<span class="md-ellipsis">
nix doctor
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-edit/" class="md-nav__link">
<span class="md-ellipsis">
nix edit
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-eval/" class="md-nav__link">
<span class="md-ellipsis">
nix eval
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-flake-archive/" class="md-nav__link">
<span class="md-ellipsis">
nix flake archive
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-flake-check/" class="md-nav__link">
<span class="md-ellipsis">
nix flake check
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-flake-clone/" class="md-nav__link">
<span class="md-ellipsis">
nix flake clone
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-flake-info/" class="md-nav__link">
<span class="md-ellipsis">
nix flake info
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-flake-init/" class="md-nav__link">
<span class="md-ellipsis">
nix flake init
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-flake-lock/" class="md-nav__link">
<span class="md-ellipsis">
nix flake lock
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-flake-metadata/" class="md-nav__link">
<span class="md-ellipsis">
nix flake metadata
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-flake-new/" class="md-nav__link">
<span class="md-ellipsis">
nix flake new
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-flake-prefetch/" class="md-nav__link">
<span class="md-ellipsis">
nix flake prefetch
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-flake-show/" class="md-nav__link">
<span class="md-ellipsis">
nix flake show
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-flake-update/" class="md-nav__link">
<span class="md-ellipsis">
nix flake update
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-flake/" class="md-nav__link">
<span class="md-ellipsis">
nix flake
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-fmt/" class="md-nav__link">
<span class="md-ellipsis">
nix fmt
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-hash-file/" class="md-nav__link">
<span class="md-ellipsis">
nix hash file
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-hash-path/" class="md-nav__link">
<span class="md-ellipsis">
nix hash path
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-hash-to-base16/" class="md-nav__link">
<span class="md-ellipsis">
nix hash to-base16
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-hash-to-base32/" class="md-nav__link">
<span class="md-ellipsis">
nix hash to-base32
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-hash-to-base64/" class="md-nav__link">
<span class="md-ellipsis">
nix hash to-base64
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-hash-to-sri/" class="md-nav__link">
<span class="md-ellipsis">
nix hash to-sri
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-hash/" class="md-nav__link">
<span class="md-ellipsis">
nix hash
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-help-stores/" class="md-nav__link">
<span class="md-ellipsis">
nix help-stores
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-help/" class="md-nav__link">
<span class="md-ellipsis">
nix help
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-key-convert-secret-to-public/" class="md-nav__link">
<span class="md-ellipsis">
nix key convert-secret-to-public
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-key-generate-secret/" class="md-nav__link">
<span class="md-ellipsis">
nix key generate-secret
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-key/" class="md-nav__link">
<span class="md-ellipsis">
nix key
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-log/" class="md-nav__link">
<span class="md-ellipsis">
nix log
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-nar-cat/" class="md-nav__link">
<span class="md-ellipsis">
nix nar cat
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-nar-dump-path/" class="md-nav__link">
<span class="md-ellipsis">
nix nar dump-path
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-nar-ls/" class="md-nav__link">
<span class="md-ellipsis">
nix nar ls
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-nar/" class="md-nav__link">
<span class="md-ellipsis">
nix nar
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-path-info/" class="md-nav__link">
<span class="md-ellipsis">
nix path-info
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-print-dev-env/" class="md-nav__link">
<span class="md-ellipsis">
nix print-dev-env
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-profile-diff-closures/" class="md-nav__link">
<span class="md-ellipsis">
nix profile diff-closures
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-profile-history/" class="md-nav__link">
<span class="md-ellipsis">
nix profile history
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-profile-install/" class="md-nav__link">
<span class="md-ellipsis">
nix profile install
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-profile-list/" class="md-nav__link">
<span class="md-ellipsis">
nix profile list
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-profile-remove/" class="md-nav__link">
<span class="md-ellipsis">
nix profile remove
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-profile-rollback/" class="md-nav__link">
<span class="md-ellipsis">
nix profile rollback
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-profile-upgrade/" class="md-nav__link">
<span class="md-ellipsis">
nix profile upgrade
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-profile-wipe-history/" class="md-nav__link">
<span class="md-ellipsis">
nix profile wipe-history
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-profile/" class="md-nav__link">
<span class="md-ellipsis">
nix profile
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-realisation-info/" class="md-nav__link">
<span class="md-ellipsis">
nix realisation info
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-realisation/" class="md-nav__link">
<span class="md-ellipsis">
nix realisation
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-registry-add/" class="md-nav__link">
<span class="md-ellipsis">
nix registry add
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-registry-list/" class="md-nav__link">
<span class="md-ellipsis">
nix registry list
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-registry-pin/" class="md-nav__link">
<span class="md-ellipsis">
nix registry pin
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-registry-remove/" class="md-nav__link">
<span class="md-ellipsis">
nix registry remove
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-registry/" class="md-nav__link">
<span class="md-ellipsis">
nix registry
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-repl/" class="md-nav__link">
<span class="md-ellipsis">
nix repl
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-run/" class="md-nav__link">
<span class="md-ellipsis">
nix run
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-search/" class="md-nav__link">
<span class="md-ellipsis">
nix search
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-shell/" class="md-nav__link">
<span class="md-ellipsis">
nix shell
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-store-add-file/" class="md-nav__link">
<span class="md-ellipsis">
nix store add-file
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-store-add-path/" class="md-nav__link">
<span class="md-ellipsis">
nix store add-path
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-store-cat/" class="md-nav__link">
<span class="md-ellipsis">
nix store cat
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-store-copy-log/" class="md-nav__link">
<span class="md-ellipsis">
nix store copy-log
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-store-copy-sigs/" class="md-nav__link">
<span class="md-ellipsis">
nix store copy-sigs
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-store-delete/" class="md-nav__link">
<span class="md-ellipsis">
nix store delete
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-store-diff-closures/" class="md-nav__link">
<span class="md-ellipsis">
nix store diff-closures
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-store-dump-path/" class="md-nav__link">
<span class="md-ellipsis">
nix store dump-path
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-store-gc/" class="md-nav__link">
<span class="md-ellipsis">
nix store gc
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-store-ls/" class="md-nav__link">
<span class="md-ellipsis">
nix store ls
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-store-make-content-addressed/" class="md-nav__link">
<span class="md-ellipsis">
nix store make-content-addressed
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-store-optimise/" class="md-nav__link">
<span class="md-ellipsis">
nix store optimise
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-store-path-from-hash-part/" class="md-nav__link">
<span class="md-ellipsis">
nix store path-from-hash-part
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-store-ping/" class="md-nav__link">
<span class="md-ellipsis">
nix store ping
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-store-prefetch-file/" class="md-nav__link">
<span class="md-ellipsis">
nix store prefetch-file
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-store-repair/" class="md-nav__link">
<span class="md-ellipsis">
nix store repair
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-store-sign/" class="md-nav__link">
<span class="md-ellipsis">
nix store sign
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-store-verify/" class="md-nav__link">
<span class="md-ellipsis">
nix store verify
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-store/" class="md-nav__link">
<span class="md-ellipsis">
nix store
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-upgrade-nix/" class="md-nav__link">
<span class="md-ellipsis">
nix upgrade-nix
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../nix3-why-depends/" class="md-nav__link">
<span class="md-ellipsis">
nix why-depends
</span>
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item md-nav__item--pruned md-nav__item--nested">
<a href="../../files/" class="md-nav__link">
<span class="md-ellipsis">
Files
</span>
<span class="md-nav__icon md-icon"></span>
</a>
</li>
<li class="md-nav__item md-nav__item--pruned md-nav__item--nested">
<a href="../../nix-env/" class="md-nav__link">
<span class="md-ellipsis">
Nix env
</span>
<span class="md-nav__icon md-icon"></span>
</a>
</li>
<li class="md-nav__item md-nav__item--pruned md-nav__item--nested">
<a href="../../nix-store/" class="md-nav__link">
<span class="md-ellipsis">
Nix store
</span>
<span class="md-nav__icon md-icon"></span>
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item md-nav__item--pruned md-nav__item--nested">
<a href="../../../Package-Management/" class="md-nav__link">
<span class="md-ellipsis">
Package Management
</span>
<span class="md-nav__icon md-icon"></span>
</a>
</li>
<li class="md-nav__item md-nav__item--pruned md-nav__item--nested">
<a href="../../../architecture/" class="md-nav__link">
<span class="md-ellipsis">
Architecture
</span>
<span class="md-nav__icon md-icon"></span>
</a>
</li>
<li class="md-nav__item md-nav__item--pruned md-nav__item--nested">
<a href="../../../contributing/" class="md-nav__link">
<span class="md-ellipsis">
Contributing
</span>
<span class="md-nav__icon md-icon"></span>
</a>
</li>
<li class="md-nav__item md-nav__item--pruned md-nav__item--nested">
<a href="../../../installation/" class="md-nav__link">
<span class="md-ellipsis">
Installation
</span>
<span class="md-nav__icon md-icon"></span>
</a>
</li>
<li class="md-nav__item md-nav__item--pruned md-nav__item--nested">
<a href="../../../language/" class="md-nav__link">
<span class="md-ellipsis">
Language
</span>
<span class="md-nav__icon md-icon"></span>
</a>
</li>
<li class="md-nav__item md-nav__item--pruned md-nav__item--nested">
<a href="../../../protocols/" class="md-nav__link">
<span class="md-ellipsis">
Protocols
</span>
<span class="md-nav__icon md-icon"></span>
</a>
</li>
<li class="md-nav__item md-nav__item--pruned md-nav__item--nested">
<a href="../../../release-notes/" class="md-nav__link">
<span class="md-ellipsis">
Release notes
</span>
<span class="md-nav__icon md-icon"></span>
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item md-nav__item--pruned md-nav__item--nested">
<a href="../../../../NixOS/appstream/" class="md-nav__link">
<span class="md-ellipsis">
NixOS
</span>
<span class="md-nav__icon md-icon"></span>
</a>
</li>
<li class="md-nav__item md-nav__item--pruned md-nav__item--nested">
<a href="../../../../Nixpkgs/" class="md-nav__link">
<span class="md-ellipsis">
Nixpkgs
</span>
<span class="md-nav__icon md-icon"></span>
</a>
</li>
</ul>
</nav>
</div>
</div>
</div>
<div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
<div class="md-sidebar__scrollwrap">
<div class="md-sidebar__inner">
<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
<label class="md-nav__title" for="__toc">
<span class="md-nav__icon md-icon"></span>
Table of contents
</label>
<ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
<li class="md-nav__item">
<a href="#synopsis" class="md-nav__link">
<span class="md-ellipsis">
Synopsis
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#examples" class="md-nav__link">
<span class="md-ellipsis">
Examples
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#description" class="md-nav__link">
<span class="md-ellipsis">
Description
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#options" class="md-nav__link">
<span class="md-ellipsis">
Options
</span>
</a>
</li>
</ul>
</nav>
</div>
</div>
</div>
<div class="md-content" data-md-component="content">
<article class="md-content__inner md-typeset">
<h1 id="nix-copy"><code>nix copy</code></h1>
<p>Copy paths between Nix stores.</p>
<div class="admonition warning">
<p class="admonition-title">Warning</p>
</div>
<blockquote>
<p>This program is
<a href="../../../contributing/experimental-features/#xp-feature-nix-command"><strong>experimental</strong></a>
and its interface is subject to change.</p>
</blockquote>
<h2 id="synopsis">Synopsis</h2>
<p><code>nix copy</code> [<em>option</em>...] <em>installables</em>...</p>
<h2 id="examples">Examples</h2>
<ul>
<li>Copy Firefox from the local store to a binary cache in <code>/tmp/cache</code>:</li>
</ul>
<div class="highlight"><pre><span></span><code><span class="gp">#</span><span class="c1"># nix copy --to file:///tmp/cache $(type -p firefox)</span>
</code></pre></div>
<p>Note the <code>file://</code> - without this, the destination is a chroot
store, not a binary cache.</p>
<ul>
<li>Copy the entire current NixOS system closure to another machine via
SSH:</li>
</ul>
<div class="highlight"><pre><span></span><code><span class="gp">#</span><span class="c1"># nix copy --substitute-on-destination --to ssh://server /run/current-system</span>
</code></pre></div>
<p>The <code>-s</code> flag causes the remote machine to try to substitute missing
store paths, which may be faster if the link between the local and
remote machines is slower than the link between the remote machine
and its substituters (e.g. <code>https://cache.nixos.org</code>).</p>
<ul>
<li>Copy a closure from another machine via SSH:</li>
</ul>
<div class="highlight"><pre><span></span><code><span class="gp">#</span><span class="c1"># nix copy --from ssh://server /nix/store/a6cnl93nk1wxnq84brbbwr6hxw9gp2w9-blender-2.79-rc2</span>
</code></pre></div>
<ul>
<li>Copy Hello to a binary cache in an Amazon S3 bucket:</li>
</ul>
<div class="highlight"><pre><span></span><code><span class="gp">#</span><span class="c1"># nix copy --to s3://my-bucket?region=eu-west-1 nixpkgs#hello</span>
</code></pre></div>
<p>or to an S3-compatible storage system:</p>
<div class="highlight"><pre><span></span><code><span class="gp">#</span><span class="c1"># nix copy --to s3://my-bucket?region=eu-west-1&amp;endpoint=example.com nixpkgs#hello</span>
</code></pre></div>
<p>Note that this only works if Nix is built with AWS support.</p>
<ul>
<li>Copy a closure from <code>/nix/store</code> to the chroot store <code>/tmp/nix/nix/store</code>:</li>
</ul>
<div class="highlight"><pre><span></span><code><span class="gp">#</span><span class="c1"># nix copy --to /tmp/nix nixpkgs#hello --no-check-sigs</span>
</code></pre></div>
<h2 id="description">Description</h2>
<p><code>nix copy</code> copies store path closures between two Nix stores. The
source store is specified using <code>--from</code> and the destination using
<code>--to</code>. If one of these is omitted, it defaults to the local store.</p>
<h2 id="options">Options</h2>
<ul>
<li>
<p><span id="opt-from"><a href="#opt-from"><code>--from</code></a></span> <em>store-uri</em>
URL of the source Nix store.</p>
</li>
<li>
<p><span id="opt-no-check-sigs"><a href="#opt-no-check-sigs"><code>--no-check-sigs</code></a></span>
Do not require that paths are signed by trusted keys.</p>
</li>
<li>
<p><span id="opt-stdin"><a href="#opt-stdin"><code>--stdin</code></a></span>
Read installables from the standard input. No default installable applied.</p>
</li>
<li>
<p><span id="opt-substitute-on-destination"><a href="#opt-substitute-on-destination"><code>--substitute-on-destination</code></a></span> / <code>-s</code>
Whether to try substitutes on the destination store (only supported by SSH stores).</p>
</li>
<li>
<p><span id="opt-to"><a href="#opt-to"><code>--to</code></a></span> <em>store-uri</em>
URL of the destination Nix store.</p>
</li>
</ul>
<p><strong>Common evaluation options:</strong></p>
<ul>
<li>
<p><span id="opt-arg"><a href="#opt-arg"><code>--arg</code></a></span> <em>name</em> <em>expr</em>
Pass the value <em>expr</em> as the argument <em>name</em> to Nix functions.</p>
</li>
<li>
<p><span id="opt-argstr"><a href="#opt-argstr"><code>--argstr</code></a></span> <em>name</em> <em>string</em>
Pass the string <em>string</em> as the argument <em>name</em> to Nix functions.</p>
</li>
<li>
<p><span id="opt-debugger"><a href="#opt-debugger"><code>--debugger</code></a></span>
Start an interactive environment if evaluation fails.</p>
</li>
<li>
<p><span id="opt-eval-store"><a href="#opt-eval-store"><code>--eval-store</code></a></span> <em>store-url</em>
The <a href="../nix3-help-stores/#store-url-format">URL of the Nix store</a>
to use for evaluation, i.e. to store derivations (<code>.drv</code> files) and inputs referenced by them.</p>
</li>
<li>
<p><span id="opt-impure"><a href="#opt-impure"><code>--impure</code></a></span>
Allow access to mutable paths and repositories.</p>
</li>
<li>
<p><span id="opt-include"><a href="#opt-include"><code>--include</code></a></span> / <code>-I</code> <em>path</em>
Add <em>path</em> to the Nix search path. The Nix search path is
initialized from the colon-separated <a href="../../env-common/#env-NIX_PATH"><code>NIX_PATH</code></a> environment
variable, and is used to look up the location of Nix expressions using <a href="../../../language/values/#type-path">paths</a> enclosed in angle
brackets (i.e., <code>&lt;nixpkgs&gt;</code>).</p>
</li>
</ul>
<p>For instance, passing</p>
<div class="highlight"><pre><span></span><code>-I /home/eelco/Dev
-I /etc/nixos
</code></pre></div>
<p>will cause Lix to look for paths relative to <code>/home/eelco/Dev</code> and
<code>/etc/nixos</code>, in that order. This is equivalent to setting the
<code>NIX_PATH</code> environment variable to</p>
<div class="highlight"><pre><span></span><code>/home/eelco/Dev:/etc/nixos
</code></pre></div>
<p>It is also possible to match paths against a prefix. For example,
passing</p>
<div class="highlight"><pre><span></span><code>-I nixpkgs=/home/eelco/Dev/nixpkgs-branch
-I /etc/nixos
</code></pre></div>
<p>will cause Lix to search for <code>&lt;nixpkgs/path&gt;</code> in
<code>/home/eelco/Dev/nixpkgs-branch/path</code> and <code>/etc/nixos/nixpkgs/path</code>.</p>
<p>If a path in the Nix search path starts with <code>http://</code> or <code>https://</code>,
it is interpreted as the URL of a tarball that will be downloaded and
unpacked to a temporary location. The tarball must consist of a single
top-level directory. For example, passing</p>
<div class="highlight"><pre><span></span><code>-I nixpkgs=https://github.com/NixOS/nixpkgs/archive/master.tar.gz
</code></pre></div>
<p>tells Lix to download and use the current contents of the <code>master</code>
branch in the <code>nixpkgs</code> repository.</p>
<p>The URLs of the tarballs from the official <code>nixos.org</code> channels
(see <a href="../../nix-channel/">the manual page for <code>nix-channel</code></a>) can be
abbreviated as <code>channel:&lt;channel-name&gt;</code>. For instance, the
following two flags are equivalent:</p>
<div class="highlight"><pre><span></span><code>-I nixpkgs=channel:nixos-21.05
-I nixpkgs=https://nixos.org/channels/nixos-21.05/nixexprs.tar.xz
</code></pre></div>
<p>You can also fetch source trees using <a href="../nix3-flake/#url-like-syntax">flake URLs</a> and add them to the
search path. For instance,</p>
<div class="highlight"><pre><span></span><code>-I nixpkgs=flake:nixpkgs
</code></pre></div>
<p>specifies that the prefix <code>nixpkgs</code> shall refer to the source tree
downloaded from the <code>nixpkgs</code> entry in the flake registry. Similarly,</p>
<div class="highlight"><pre><span></span><code>-I nixpkgs=flake:github:NixOS/nixpkgs/nixos-22.05
</code></pre></div>
<p>makes <code>&lt;nixpkgs&gt;</code> refer to a particular branch of the
<code>NixOS/nixpkgs</code> repository on GitHub.</p>
<ul>
<li><span id="opt-override-flake"><a href="#opt-override-flake"><code>--override-flake</code></a></span> <em>original-ref</em> <em>resolved-ref</em>
Override the flake registries, redirecting <em>original-ref</em> to <em>resolved-ref</em>.</li>
</ul>
<p><strong>Common flake-related options:</strong></p>
<ul>
<li>
<p><span id="opt-commit-lock-file"><a href="#opt-commit-lock-file"><code>--commit-lock-file</code></a></span>
Commit changes to the flake's lock file.</p>
</li>
<li>
<p><span id="opt-inputs-from"><a href="#opt-inputs-from"><code>--inputs-from</code></a></span> <em>flake-url</em>
Use the inputs of the specified flake as registry entries.</p>
</li>
<li>
<p><span id="opt-no-registries"><a href="#opt-no-registries"><code>--no-registries</code></a></span>
Don't allow lookups in the flake registries. This option is deprecated; use <code>--no-use-registries</code>.</p>
</li>
<li>
<p><span id="opt-no-update-lock-file"><a href="#opt-no-update-lock-file"><code>--no-update-lock-file</code></a></span>
Do not allow any updates to the flake's lock file.</p>
</li>
<li>
<p><span id="opt-no-write-lock-file"><a href="#opt-no-write-lock-file"><code>--no-write-lock-file</code></a></span>
Do not write the flake's newly generated lock file.</p>
</li>
<li>
<p><span id="opt-output-lock-file"><a href="#opt-output-lock-file"><code>--output-lock-file</code></a></span> <em>flake-lock-path</em>
Write the given lock file instead of <code>flake.lock</code> within the top-level flake.</p>
</li>
<li>
<p><span id="opt-override-input"><a href="#opt-override-input"><code>--override-input</code></a></span> <em>input-path</em> <em>flake-url</em>
Override a specific flake input (e.g. <code>dwarffs/nixpkgs</code>). This implies <code>--no-write-lock-file</code>.</p>
</li>
<li>
<p><span id="opt-reference-lock-file"><a href="#opt-reference-lock-file"><code>--reference-lock-file</code></a></span> <em>flake-lock-path</em>
Read the given lock file instead of <code>flake.lock</code> within the top-level flake.</p>
</li>
</ul>
<p><strong>Logging-related options:</strong></p>
<ul>
<li>
<p><span id="opt-debug"><a href="#opt-debug"><code>--debug</code></a></span>
Set the logging verbosity level to 'debug'.</p>
</li>
<li>
<p><span id="opt-log-format"><a href="#opt-log-format"><code>--log-format</code></a></span> <em>format</em>
Set the format of log output; one of <code>raw</code>, <code>internal-json</code>, <code>bar</code> or <code>bar-with-logs</code>.</p>
</li>
<li>
<p><span id="opt-print-build-logs"><a href="#opt-print-build-logs"><code>--print-build-logs</code></a></span> / <code>-L</code>
Print full build logs on standard error.</p>
</li>
<li>
<p><span id="opt-quiet"><a href="#opt-quiet"><code>--quiet</code></a></span>
Decrease the logging verbosity level.</p>
</li>
<li>
<p><span id="opt-verbose"><a href="#opt-verbose"><code>--verbose</code></a></span> / <code>-v</code>
Increase the logging verbosity level.</p>
</li>
</ul>
<p><strong>Miscellaneous global options:</strong></p>
<ul>
<li>
<p><span id="opt-help"><a href="#opt-help"><code>--help</code></a></span>
Show usage information.</p>
</li>
<li>
<p><span id="opt-offline"><a href="#opt-offline"><code>--offline</code></a></span>
Disable substituters and consider all previously downloaded files up-to-date.</p>
</li>
<li>
<p><span id="opt-option"><a href="#opt-option"><code>--option</code></a></span> <em>name</em> <em>value</em>
Set the Lix configuration setting <em>name</em> to <em>value</em> (overriding <code>nix.conf</code>).</p>
</li>
<li>
<p><span id="opt-refresh"><a href="#opt-refresh"><code>--refresh</code></a></span>
Consider all previously downloaded files out-of-date.</p>
</li>
<li>
<p><span id="opt-repair"><a href="#opt-repair"><code>--repair</code></a></span>
During evaluation, rewrite missing or corrupted files in the Nix store. During building, rebuild missing or corrupted store paths.</p>
</li>
<li>
<p><span id="opt-version"><a href="#opt-version"><code>--version</code></a></span>
Show version information.</p>
</li>
</ul>
<p><strong>Options that change the interpretation of <a href="../nix/#installables">installables</a>:</strong></p>
<ul>
<li>
<p><span id="opt-all"><a href="#opt-all"><code>--all</code></a></span>
Apply the operation to every store path.</p>
</li>
<li>
<p><span id="opt-derivation"><a href="#opt-derivation"><code>--derivation</code></a></span>
Operate on the <a href="../../../glossary/#gloss-store-derivation">store derivation</a> rather than its outputs.</p>
</li>
<li>
<p><span id="opt-expr"><a href="#opt-expr"><code>--expr</code></a></span> / <code>-E</code> <em>expr</em>
Interpret <a href="../nix/#installables"><em>installables</em></a> as attribute paths relative to the Nix expression <em>expr</em>.</p>
</li>
<li>
<p><span id="opt-file"><a href="#opt-file"><code>--file</code></a></span> / <code>-f</code> <em>file</em>
Interpret <a href="../nix/#installables"><em>installables</em></a> as attribute paths relative to the Nix expression stored in <em>file</em>. If <em>file</em> is the character -, then a Nix expression will be read from standard input. Implies <code>--impure</code>.</p>
</li>
<li>
<p><span id="opt-no-recursive"><a href="#opt-no-recursive"><code>--no-recursive</code></a></span>
Apply operation to specified paths only.</p>
</li>
</ul>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>See <a href="../../conf-file/#command-line-flags"><code>man nix.conf</code></a> for overriding configuration settings with command line flags.</p>
</div>
</article>
</div>
<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
</div>
</main>
<footer class="md-footer">
<div class="md-footer-meta md-typeset">
<div class="md-footer-meta__inner md-grid">
<div class="md-copyright">
<div class="md-copyright__highlight">
Licenced MIT
</div>
Made with
<a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
Material for MkDocs
</a>
</div>
<div class="md-social">
<a href="https://git.auxolotl.org/auxolotl/docs" target="_blank" rel="noopener" title="Aux Docs Repo" class="md-social__link">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M16.777 0a2.9 2.9 0 1 1-2.529 4.322H12.91a4.266 4.266 0 0 0-4.265 4.195v2.118a7.076 7.076 0 0 1 4.147-1.42l.118-.002h1.338a2.9 2.9 0 0 1 5.43 1.422 2.9 2.9 0 0 1-5.43 1.422H12.91a4.266 4.266 0 0 0-4.265 4.195v2.319A2.9 2.9 0 0 1 7.222 24 2.9 2.9 0 0 1 5.8 18.57V8.589a7.109 7.109 0 0 1 6.991-7.108l.118-.001h1.338A2.9 2.9 0 0 1 16.778 0ZM7.223 19.905a1.194 1.194 0 1 0 0 2.389 1.194 1.194 0 0 0 0-2.389Zm9.554-10.464a1.194 1.194 0 1 0 0 2.389 1.194 1.194 0 0 0 0-2.39Zm0-7.735a1.194 1.194 0 1 0 0 2.389 1.194 1.194 0 0 0 0-2.389Z"/></svg>
</a>
<a href="https://forum.aux.computer/" target="_blank" rel="noopener" title="Aux Forum" class="md-social__link">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12.103 0C18.666 0 24 5.485 24 11.997c0 6.51-5.33 11.99-11.9 11.99L0 24V11.79C0 5.28 5.532 0 12.103 0zm.116 4.563a7.395 7.395 0 0 0-6.337 3.57 7.247 7.247 0 0 0-.148 7.22L4.4 19.61l4.794-1.074a7.424 7.424 0 0 0 8.136-1.39 7.256 7.256 0 0 0 1.737-7.997 7.375 7.375 0 0 0-6.84-4.585h-.008z"/></svg>
</a>
<a href="https://wiki.auxolotl.org/" target="_blank" rel="noopener" title="Aux Wiki" class="md-social__link">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M17.801 13.557c.148.098.288.202.417.313 1.854 1.6 3.127 4.656 2.582 7.311-1.091-.255-5.747-1.055-7.638-3.383-.91-1.12-1.366-2.081-1.569-2.885a5.65 5.65 0 0 0 .034-.219c.089.198.197.35.313.466.24.24.521.335.766.372.304.046.594-.006.806-.068l.001.001c.05-.015.433-.116.86-.342.325-.173 2.008-.931 3.428-1.566Zm-7.384 1.435C9.156 16.597 6.6 18.939.614 18.417c.219-1.492 1.31-3.019 2.51-4.11.379-.345.906-.692 1.506-1.009.286.168.598.332.939.486 2.689 1.221 3.903 1.001 4.89.573a1.3 1.3 0 0 0 .054-.025 6.156 6.156 0 0 0-.096.66Zm4.152-.462c.38-.341.877-.916 1.383-1.559-.389-.15-.866-.371-1.319-.591-.598-.29-1.305-.283-2.073-.315a4.685 4.685 0 0 1-.804-.103c.014-.123.027-.246.038-.369.062.104.673.057.871.057.354 0 1.621.034 3.074-.574 1.452-.608 2.55-1.706 3.022-3.225.474-1.52.22-3.091-.168-3.952-.169.709-1.453 2.381-1.926 2.871-.473.489-2.381 2.296-2.972 2.921-.7.74-.688.793-1.332 1.302-.202.19-.499.402-.563.53.027-.338.039-.675.027-.997a7.653 7.653 0 0 0-.032-.523c.322-.059.567-.522.567-.861 0-.224-.106-.247-.271-.229.075-.894.382-3.923 1.254-4.281.218.109.831.068.649-.295-.182-.364-.825-.074-1.081.266-.28.374-.956 2.046-.92 4.324-.113.014-.174.033-.322.033-.171 0-.321-.04-.433-.05.034-2.275-.714-3.772-.84-4.169-.12-.375-.491-.596-.781-.596-.146 0-.272.056-.333.179-.182.363.459.417.677.308.706.321 1.156 3.519 1.254 4.277-.125-.006-.199.035-.199.233 0 .311.17.756.452.843a.442.442 0 0 0-.007.03s-.287.99-.413 2.189a4.665 4.665 0 0 1-.718-.225c-.714-.286-1.355-.583-2.019-.566-.664.018-1.366.023-1.804-.036-.438-.058-.649-.15-.649-.15s-.234.365.257 1.075c.42.607 1.055 1.047 1.644 1.18.589.134 1.972.18 2.785-.377.16-.109.317-.228.459-.34a8.717 8.717 0 0 0-.013.626c-.289.753-.571 1.993-.268 3.338 0-.001.701-.842.787-2.958.006-.144.009-.271.01-.383.052-.248.103-.518.148-.799.072.135.151.277.234.413.511.842 1.791 1.37 2.383 1.49.091.019.187.032.285.038Zm-1.12.745c-.188.055-.445.1-.713.059-.21-.031-.45-.11-.655-.316-.169-.168-.312-.419-.401-.789a9.837 9.837 0 0 0 .039-.82l.049-.243c.563.855 1.865 1.398 2.476 1.522.036.008.072.014.109.02l-.013.009c-.579.415-.76.503-.891.558Zm6.333-2.818c-.257.114-4.111 1.822-5.246 2.363.98-.775 3.017-3.59 3.699-4.774 1.062.661 1.468 1.109 1.623 1.441.101.217.09.38.096.515a.57.57 0 0 1-.172.455Zm-9.213 1.62a1.606 1.606 0 0 1-.19.096c-.954.414-2.126.61-4.728-.571-2.023-.918-3.024-2.157-3.371-2.666.476.161 1.471.473 2.157.524.282.021.703.068 1.167.125.021.209.109.486.345.829l.001.001c.451.651 1.134 1.119 1.765 1.262.622.141 2.083.182 2.942-.407a3.12 3.12 0 0 0 .132-.093l.001.179a6.052 6.052 0 0 0-.221.721Zm5.512-1.271a17.49 17.49 0 0 1-1.326-.589c.437.042 1.054.083 1.692.108-.121.162-.244.323-.366.481Zm.932-1.26c-.12.17-.245.343-.373.517-.241.018-.478.03-.709.038a29.05 29.05 0 0 1-.741-.048c.608-.065 1.228-.252 1.823-.507Zm.22-.315c-.809.382-1.679.648-2.507.648-.472 0-.833.018-1.139.039v.001c-.324-.031-.665-.039-1.019-.054a3.555 3.555 0 0 1-.152-.009c.102-.002.192-.006.249-.006.363 0 1.662.034 3.151-.589 1.508-.632 2.645-1.773 3.136-3.351.37-1.186.31-2.402.086-3.312.458-.336.86-.651 1.147-.91.501-.451.743-.733.848-.869.199.206.714.864.685 2.138-.036 1.611-.606 3.187-1.501 4.154a9.099 9.099 0 0 1-1.321 1.132 11.978 11.978 0 0 0-.644-.422l-.089-.055-.051.091c-.184.332-.5.825-.879 1.374ZM4.763 5.817c-.157 1.144.113 2.323.652 3.099.539.776 2.088 2.29 3.614 2.505.991.14 2.055.134 2.055.134s-.593-.576-1.114-1.66c-.521-1.085-.948-2.104-1.734-2.786-.785-.681-1.601-1.416-2.045-1.945-.444-.53-.59-.86-.59-.86s-.656.175-.838 1.513Zm14.301 4.549a9.162 9.162 0 0 0 1.3-1.12c.326-.352.611-.782.845-1.265 1.315.145 2.399.371 2.791.434 0 0-.679 1.971-3.945 3.022l-.016-.035c-.121-.26-.385-.594-.975-1.036Zm-11.634.859a8.537 8.537 0 0 1-.598-.224c-1.657-.693-2.91-1.944-3.449-3.678-.498-1.601-.292-3.251.091-4.269.225.544.758 1.34 1.262 2.01a3.58 3.58 0 0 0-.172.726c-.163 1.197.123 2.428.687 3.24.416.599 1.417 1.62 2.555 2.193-.128.002-.253.003-.376.002Zm-1.758-.077c-.958-.341-1.901-.787-2.697-1.368C-.07 7.559 0 6.827 0 6.827s1.558-.005 3.088.179c.03.126.065.251.104.377.557 1.791 1.851 3.086 3.562 3.803l.047.019a4.254 4.254 0 0 1-.267-.026h-.001c-.401-.053-.595-.135-.595-.135l-.157-.069-.092.144-.017.029Zm6.807-1.59c.086.017.136.058.136.145 0 .197-.242.5-.597.597l-.01-.161a.887.887 0 0 0 .283-.243c.078-.099.142-.217.188-.338Zm-1.591.006c.033.1.076.197.129.282.061.097.134.18.217.24l-.021.083c-.276-.093-.424-.293-.424-.466 0-.078.035-.119.099-.139Zm-.025-.664c-.275-.816-.795-2.022-1.505-2.179-.296.072-.938.096-.691-.145.246-.24 1.085-.048 1.283.217.145.194.744.806 1.011 1.737l.032.227a.324.324 0 0 0-.13.143Zm1.454-.266c.251-.99.889-1.639 1.039-1.841.197-.265 1.036-.457 1.283-.217.247.241-.395.217-.691.145-.69.152-1.2 1.296-1.481 2.109a.364.364 0 0 0-.067-.059.37.37 0 0 0-.092-.043l.009-.094Zm4.802-2.708a9.875 9.875 0 0 1-.596.705c-.304.315-1.203 1.176-1.963 1.916.647-.955 1.303-1.806 2.184-2.376.123-.08.249-.161.375-.245Z"/></svg>
</a>
</div>
</div>
</div>
</footer>
</div>
<div class="md-dialog" data-md-component="dialog">
<div class="md-dialog__inner md-typeset"></div>
</div>
<script id="__config" type="application/json">{"base": "../../../..", "features": ["content.tooltips", "search.highlight", "navigation.tabs", "navigation.indexes", "navigation.prune"], "search": "../../../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
<script src="../../../../assets/javascripts/bundle.fe8b6f2b.min.js"></script>
</body>
</html>