DUB-RUN(1)

📦
version 1.42.0 · 9 versions
, in arch rolling

💅 DUB-RUN(1) — the dub run glow-up

okay bestie, welcome to dub-run, brought to you by The D Language Foundation ✨ this is the manual page for the default command, and yes it's giving main character energy.

🎀 NAME

dub-run — builds and runs a package (this is the default command, iykyk)

🦋 SYNOPSIS

dub run [<package>[@<version-spec>]] OPTIONS...  [-- <application arguments...>]

literally just drop your package in there and go, fr fr 💅

🌸 DESCRIPTION

Builds and runs a package. If you don't pass a package, it lowkey just uses the main package in the current working directory by default. iconic behavior honestly 🫶

✨ OPTIONS ✨

  • --temp-build — builds the project in the temp folder if possible. cozy little temp-home build 🏠
  • --rdmd — uses rdmd instead of directly invoking the compiler. different vibe, same energy.
  • -f, --force — forces a recompilation even if the target is already up to date. no cap, it rebuilds anyway 🔥
  • -y, --yes — automatic yes to prompts. assumes "yes" as the answer to all interactive prompts. she's agreeable like that 💖
  • -n, --non-interactive — don't enter interactive mode. bye bestie, no questions today 🙈
  • --deep — build all dependencies, even when the main target is a static library. deep dive, literally.
  • --dest=VALUE — base directory in which output artifacts will be placed. where the glow-up products live 💅
  • -b, --build=VALUE — specifies the type of build to perform. heads up: setting the DFLAGS environment variable will override the build type with custom flags, so watch out for that lil plot twist 😭 possible names:
    • debug, plain, release, release-debug, release-nobounds, unittest, profile, profile-gc, docs, ddox, cov, cov-ctfe, unittest-cov, unittest-cov-ctfe, syntax and custom types
  • -c, --config=VALUE — builds the specified configuration. configurations can be defined in dub.json 🗂️
  • --override-config=VALUE — uses the specified configuration for a certain dependency. can be specified multiple times. format: --override-config=<dependency>/<config> 🎯
  • --compiler=VALUE — specifies the compiler binary to use (can be a path). arbitrary pre- and suffixes to the identifiers below are recognized (e.g. ldc2 or dmd-2.063) and matched to the proper compiler type: dmd, gdc, ldc, gdmd, ldmd ⚙️
  • -a, --arch=VALUE — force a different architecture (e.g. x86 or x86_64). architecture is a choice 💁‍♀️
  • -d, --debug=VALUE — define the specified debug version identifier when building — can be used multiple times. stack 'em up 🧚
  • --d-version=VALUE — define the specified version identifier when building — can be used multiple times. use sparingly, with great power comes great responsibility! 🕷️ for commonly used or combined versions and versions that dependees should be able to use, create configurations in your package instead. periodt.
  • --nodeps — do not resolve missing dependencies before building. living dangerously, love that for you 💀
  • --build-mode=VALUE — specifies the way the compiler and linker are invoked. valid values: separate (default), allAtOnce, singleFile 🌀
  • --single — treats the package name as a filename. the file must contain a package recipe comment. one file, one dream ⭐
  • --force-remove — deprecated option that does nothing. she's literally just standing there. respectfully, ignore her 🙈
  • --filter-versions — [Experimental] filter version identifiers and debug version identifiers to improve build cache efficiency. science is happening 🧪
  • --combined — tries to build the whole project in a single compiler run. one big group hug 🫶
  • --print-builds — prints the list of available build types. show me the menu 👑
  • --print-configs — prints the list of available configurations. same energy, different list.
  • --print-platform — prints the identifiers for the current build platform as used for the build fields in dub.json 🌈
  • --parallel — runs multiple compiler instances in parallel, if possible. multitasking queen 👑

💜 COMMON OPTIONS

see dub(1) — the mothership has the deets 🛸

💀 EXIT STATUS

  • 0 — DUB succeeded. we ate and left no crumbs 🔥
  • 1 — usage errors, unknown command line flags 🚩
  • 2 — package not found, package failed to load, miscellaneous error 😭

🍓 FILES

dub.sdl, dub.json — your recipe files, keep them close 💖

🧚 AUTHOR

Copyright (c) 1999-2026 by The D Language Foundation. legends only 👑

🌟 ONLINE DOCUMENTATION

http://code.dlang.org/docs/commandline ⟨⟩ — go read, bestie 📚

👑 SEE ALSO

dub(1), dub-build(1), dub-test(1), rdmd(1) — the whole friend group fr fr 🫶

aaaand that's the page! brought to you by The D Language Foundation, dated 2026-08-16, version vibes intact 💅✨ mwah, go build something iconic 🎀

📦 where this page comes from