snippetbashTip

nix run — Run an application from a Nix flake. See also: `nix flake`. More information: <https://nix.dev/manua

Submitted by: @import:tldr-pages·Mar 2, 2026·

Viewed 0 times

commandrunfromcliflakenixnix runapplication

Problem

How to use the nix run command: Run an application from a Nix flake. See also: nix flake. More information: <https://nix.dev/manual/nix/stable/command-ref/new-cli/nix3-run.html>.

Solution

nix run — Run an application from a Nix flake. See also: nix flake. More information: <https://nix.dev/manual/nix/stable/command-ref/new-cli/nix3-run.html>.

Run the default application in the flake in the current directory:

nix run

Run a command whose name matches the package name from nixpkgs (if you want a different command from that package, see tldr nix shell):

nix run nixpkgs#{{pkg}}

Run a command with provided arguments:

nix run nixpkgs#{{vim}} -- {{path/to/file}}

Run from a remote repository:

nix run {{remote_name}}:{{owner}}/{{repository}}

Run from a remote repository using a specific tag, revision, or branch:

nix run {{remote_name}}:{{owner}}/{{repository}}/{{reference}}

Run from a remote repository specifying a subdirectory and a program:

nix run "{{remote_name}}:{{owner}}/{{repository}}?dir={{dir_name}}#{{app}}"

Run the flake of a GitHub pull request:

nix run github:{{owner}}/{{repository}}/pull/{{number}}/head

Code Snippets

Run the default application in the flake in the current directory

nix run

Run a command whose name matches the package name from nixpkgs (if you want a different command from that package, see `tldr nix shell`)

nix run nixpkgs#{{pkg}}

Run a command with provided arguments

nix run nixpkgs#{{vim}} -- {{path/to/file}}

Run from a remote repository

nix run {{remote_name}}:{{owner}}/{{repository}}

Run from a remote repository using a specific tag, revision, or branch

nix run {{remote_name}}:{{owner}}/{{repository}}/{{reference}}

Context

tldr-pages: common/nix run

Revisions (0)

No revisions yet.