diff --git a/devbox.json b/devbox.json
index 16947406e18..7b263cb4a99 100644
--- a/devbox.json
+++ b/devbox.json
@@ -23,4 +23,4 @@
   "nixpkgs": {
     "commit": "3364b5b117f65fe1ce65a3cdd5612a078a3b31e3"
   }
-}
+}
\ No newline at end of file
diff --git a/docs/app/docs/cli_reference/devbox_create.md b/docs/app/docs/cli_reference/devbox_create.md
new file mode 100644
index 00000000000..215a388e5d0
--- /dev/null
+++ b/docs/app/docs/cli_reference/devbox_create.md
@@ -0,0 +1,39 @@
+# devbox create
+
+Initialize a directory as a devbox project using a template
+
+## Synopsis
+
+Initialize a directory as a devbox project. This will create an empty devbox.json in the current directory. You can then add packages using `devbox add`
+
+```bash
+devbox create [dir] --template <template> [flags]
+```
+
+## List of templates
+
+* [**go**](https://github.com/jetpack-io/devbox/tree/main/examples/development/go)
+* [**node-npm**](https://github.com/jetpack-io/devbox/tree/main/examples/development/nodejs/nodejs-npm/)
+* [**node-typescript**](https://github.com/jetpack-io/devbox/tree/main/examples/development/nodejs/nodejs-typescript/)
+* [**node-yarn**](https://github.com/jetpack-io/devbox/tree/main/examples/development/nodejs/nodejs-yarn/)
+* [**php**](https://github.com/jetpack-io/devbox/tree/main/examples/development/php/)
+* [**python-pip**](https://github.com/jetpack-io/devbox/tree/main/examples/development/python/pip/)
+* [**python-pipenv**](https://github.com/jetpack-io/devbox/tree/main/examples/development/python/pipenv/)
+* [**python-poetry**](https://github.com/jetpack-io/devbox/tree/main/examples/development/python/poetry/)
+* [**ruby**](https://github.com/jetpack-io/devbox/tree/main/examples/development/ruby/)
+* [**rust**](https://github.com/jetpack-io/devbox/tree/main/examples/development/rust/)
+
+
+## Options
+
+<!--Markdown Table of Options  -->
+| Option | Description |
+| --- | --- |
+| `-h, --help` | help for init |
+| `-t, --template string` | Template to use for the project.
+| `-q, --quiet` | Quiet mode: Suppresses logs. |
+
+## SEE ALSO
+
+* [devbox](./devbox.md)	 - Instant, easy, predictable shells and containers
+
diff --git a/docs/app/docs/cli_reference/devbox_global_install.md b/docs/app/docs/cli_reference/devbox_global_install.md
new file mode 100644
index 00000000000..b4a3e4f1240
--- /dev/null
+++ b/docs/app/docs/cli_reference/devbox_global_install.md
@@ -0,0 +1,19 @@
+# devbox global install
+
+Install all packages mentioned in your global devbox.json.
+
+```bash
+devbox global install <pkg>... [flags]
+```
+
+## Options
+
+<!-- Markdown Table of Options -->
+| Option | Description |
+| --- | --- |
+| `-h, --help` | help for global install |
+| `-q, --quiet` | suppresses logs |
+
+## SEE ALSO
+
+* [devbox global](devbox_global.md)	 - Manages global Devbox packages
diff --git a/docs/app/docs/cli_reference/devbox_global_run.md b/docs/app/docs/cli_reference/devbox_global_run.md
new file mode 100644
index 00000000000..733d8fca70a
--- /dev/null
+++ b/docs/app/docs/cli_reference/devbox_global_run.md
@@ -0,0 +1,37 @@
+# devbox global run
+
+Starts a new shell and runs your script or command in it, exiting when done.
+
+The script must be defined in `devbox.json`, or else it will be interpreted as an arbitrary command. You can pass arguments to your script or command. Everything after `--` will be passed verbatim into your command (see example)
+
+```bash
+devbox global run <pkg>... [flags]
+```
+
+## Examples
+
+Run a command directly:
+
+```bash
+  devbox add cowsay
+  devbox global run cowsay hello
+  devbox global run -- cowsay -d hello
+```
+
+Run a script (defined as `"moo": "cowsay moo"`) in your devbox.json:
+
+```bash
+  devbox global run moo
+```
+
+## Options
+
+<!-- Markdown Table of Options -->
+| Option | Description |
+| --- | --- |
+| `-h, --help` | help for global run |
+| `-q, --quiet` | suppresses logs |
+
+## SEE ALSO
+
+* [devbox global](devbox_global.md)	 - Manages global Devbox packages
diff --git a/docs/app/docs/cli_reference/devbox_global_services.md b/docs/app/docs/cli_reference/devbox_global_services.md
new file mode 100644
index 00000000000..92c2d869c71
--- /dev/null
+++ b/docs/app/docs/cli_reference/devbox_global_services.md
@@ -0,0 +1,19 @@
+# devbox global services
+
+Interact with Devbox services for your global packages. This command replicates the subcommands for [devbox services](devbox_services.md) but for your global packages.
+
+```bash
+devbox global services [command]
+```
+
+## Options
+
+<!-- Markdown Table of Options -->
+| Option | Description |
+| --- | --- |
+| `-h, --help` | help for global services |
+| `-q, --quiet` | suppresses logs |
+
+## SEE ALSO
+
+* [devbox global](devbox_global.md)	 - Manages global Devbox packages
diff --git a/docs/app/docs/cli_reference/devbox_global_update.md b/docs/app/docs/cli_reference/devbox_global_update.md
new file mode 100644
index 00000000000..b41e74e90ee
--- /dev/null
+++ b/docs/app/docs/cli_reference/devbox_global_update.md
@@ -0,0 +1,27 @@
+# devbox global update
+
+Updates packages in your Devbox global config to the latest available version.
+
+## Synopsis
+
+If you provide this command with a list of packages, it will update those packages to the latest available version based on the version tag provided.
+
+For example: if your global config has `python@3.11` in your package list, running `devbox update` will update to the latest patch version of `python 3.11`.
+
+If no packages are provided, this command will update all the versioned packages to the latest acceptable version.
+
+```bash
+devbox update [pkg]... [flags]
+```
+
+## Options
+
+<!-- Markdown Table of Options -->
+| Option | Description |
+| --- | --- |
+| `-h, --help` | help for update |
+| `-q, --quiet` | suppresses logs |
+
+## SEE ALSO
+
+* [devbox global](devbox_global.md)	 - Manages global Devbox packages
diff --git a/docs/app/docs/devbox_examples/databases/mariadb.md b/docs/app/docs/devbox_examples/databases/mariadb.md
index 3473b452f85..ad81ffb4171 100644
--- a/docs/app/docs/devbox_examples/databases/mariadb.md
+++ b/docs/app/docs/devbox_examples/databases/mariadb.md
@@ -1,7 +1,7 @@
 ---
 title: MariaDB
 ---
-To use a local MariaDB for development with Devbox and Nix, you will need to configure MariaDB to install and manage the configuration locally. This can be done using Environment variables to create the data directory, pidfile, and unix sock locally.
+MariaDB can be automatically configured for your dev environment by Devbox via the built-in MariaDB Plugin. This plugin will activate automatically when you install MariaDB using `devbox add mariadb`, or when you use a versioned Nix package like `devbox add mariadb_1010`
 
 [**Example Repo**](https://github.com/jetpack-io/devbox/tree/main/examples/databases/mariadb)
 
@@ -13,47 +13,50 @@ To use a local MariaDB for development with Devbox and Nix, you will need to con
 
 ```json
     "packages": [
-        "mariadb"
+        "mariadb@latest"
     ]
 ```
 
-## Environment Variables
+You can manually add the MariaDB Plugin to your `devbox.json` by adding it to your `includes` list:
 
-This script should be sourced in the `init_hook` of our devbox.json. This sets environment variables needed to configure and start MariaDB, as well as setting the data directory to a local folder. 
-
-```bash
-# Environment variables for running MariaDB with local configuration
-export MYSQL_BASEDIR=$(which mariadb | sed -r "s/\/bin\/mariadb//g")
-export MYSQL_HOME=$PWD/conf/mysql # or another folder in your project directory
-# Store DB data in a local folder
-export MYSQL_DATADIR=$MYSQL_HOME/data
-# Keep the socket and pidfile in our conf folder, and out of the Nix Store
-export MYSQL_UNIX_PORT=$MYSQL_HOME/mysql.sock
-export MYSQL_PID_FILE=$MYSQL_HOME/mysql.pid
+```json
+    "includes": [
+        "plugin:mariadb"
+    ]
 ```
 
-## Installing the Database
-We can check if the MySQL data directory exists, and if not install the database using the environment variables we configured:
+## MariaDB Plugin Support
+
+Devbox will automatically create the following configuration when you run `devbox add mariadb`. You can view the full configuration by running `devbox info mariadb`
 
-```bash
-    if [ ! -d "$MYSQL_DATADIR" ]; then
-    # Install the Database
-       mysql_install_db --auth-root-authentication-method=normal \
-         --datadir=$MYSQL_DATADIR --basedir=$MYSQL_BASEDIR \
-         --pid-file=$MYSQL_PID_FILE
-    fi
-```
 
-## Starting the Daemon
-Similarly, we can start the database using mysqld, passing the environment variables where needed
+### Services
+* mariadb
+
+You can use `devbox services up|stop mariadb` to start or stop the MariaDB Server.
+
+### Environment Variables
 
 ```bash
-    mysqld --datadir=$MYSQL_DATADIR --pid-file=$MYSQL_PID_FILE \
-	    --socket=$MYSQL_UNIX_PORT 2> $MYSQL_HOME/mysql.log & MYSQL_PID=$!
+MYSQL_BASEDIR=.devbox/nix/profile/default
+MYSQL_HOME=./.devbox/virtenv/mariadb/run
+MYSQL_DATADIR=./.devbox/virtenv/mariadb/data
+MYSQL_UNIX_PORT=./.devbox/virtenv/mariadb/run/mysql.sock
+MYSQL_PID_FILE=./.devbox/mariadb/run/mysql.pid
 ```
 
-The daemon can be terminated using `mysqladmin`: 
+### Files
 
-```bash
-  mysqladmin -u root --socket=$MYSQL_UNIX_PORT shutdown
-```
\ No newline at end of file
+The plugin will also create the following helper files in your project's `.devbox/virtenv` folder:
+
+* mariadb/flake.nix
+* mariadb/setup_db.sh
+* mariadb/process-compose.yaml
+
+These files are used to setup your database and service, and should not be modified
+
+### Notes
+
+* This plugin wraps mysqld and mysql_install_db to work in your local project. For more information, see the `flake.nix` created in your `.devbox/virtenv/mariadb` folder.
+* This plugin will create a new database for your project in MYSQL_DATADIR if one doesn't exist on shell init.
+* You can use `mysqld` to manually start the server, and `mysqladmin -u root shutdown` to manually stop it
diff --git a/docs/app/docs/devbox_examples/databases/postgres.md b/docs/app/docs/devbox_examples/databases/postgres.md
index 05b04c3ba98..2fc988364e5 100644
--- a/docs/app/docs/devbox_examples/databases/postgres.md
+++ b/docs/app/docs/devbox_examples/databases/postgres.md
@@ -13,11 +13,13 @@ PostgreSQL can be automatically configured by Devbox via the built-in Postgres P
 
 ```json
     "packages": [
-        "postgresql",
-        "glibcLocales"
+        "postgresql@latest",
+        "glibcLocales@latest"
     ]
 ```
 
+This will install the latest version of Postgres. You can find other installable versions of Postgres by running `devbox search postgresql`.
+
 ## PostgreSQL Plugin Support
 
 Devbox will automatically create the following configuration when you run `devbox add postgresql`:
@@ -32,7 +34,7 @@ You can use `devbox services start|stop postgresql` to start or stop the Postgre
 `PGHOST=./.devbox/virtenv/postgresql`
 `PGDATA=./.devbox/virtenv/postgresql/data`
 
-This variable tells PostgreSQL which directory to use for creating and storing databases. 
+This variable tells PostgreSQL which directory to use for creating and storing databases.
 
 ### Notes
 
diff --git a/docs/app/docs/devbox_examples/databases/redis.md b/docs/app/docs/devbox_examples/databases/redis.md
index c73a68c39b2..a44e8f426fb 100644
--- a/docs/app/docs/devbox_examples/databases/redis.md
+++ b/docs/app/docs/devbox_examples/databases/redis.md
@@ -14,10 +14,12 @@ Redis can be configured automatically using Devbox's built in Redis plugin. This
 
 ```json
     "packages": [
-        "redis"
+        "redis@latest   "
     ],
 ```
 
+This will install the latest version of Redis. You can find other installable versions of Redis by running `devbox search redis`.
+
 ## Redis Plugin Details
 
 The Redis plugin will automatically create the following configuration when you install Redis with `devbox add`
@@ -48,4 +50,4 @@ Running `devbox services start redis` will start redis as a daemon in the backgr
 
 You can manually start Redis in the foreground by running `redis-server $REDIS_CONF --port $REDIS_PORT`.
 
-Logs, pidfile, and data dumps are stored in `.devbox/virtenv/redis`. You can change this by modifying the `dir` directive in `devbox.d/redis/redis.conf`
\ No newline at end of file
+Logs, pidfile, and data dumps are stored in `.devbox/virtenv/redis`. You can change this by modifying the `dir` directive in `devbox.d/redis/redis.conf`
diff --git a/docs/app/docs/devbox_examples/languages/csharp.md b/docs/app/docs/devbox_examples/languages/csharp.md
index 5e4e56ee39b..36890bf5f26 100644
--- a/docs/app/docs/devbox_examples/languages/csharp.md
+++ b/docs/app/docs/devbox_examples/languages/csharp.md
@@ -14,17 +14,11 @@ C# and .NET projects can be easily generated in Devbox by adding the dotnet SDK
 
 ```json
   "packages": [
-    "dotnet-sdk"
+    "dotnet-sdk@latest"
   ],
 ```
-This will install .NET SDK 6.0
-
-Other versions available include: 
-
-* dotnet-sdk_7 (version 7.0)
-* dotnet-sdk_5 (version 5.0)
-* dotnet-sdk_3 (version 3.1)
+This will install the latest version of the dotnet SDK. You can find other installable versions of the dotnet SDK by running `devbox search dotnet-sdk`.
 
 ## Creating a new C# Project
 
-`dotnet new console -lang "C#" -o <name>`
\ No newline at end of file
+`dotnet new console -lang "C#" -o <name>`
diff --git a/docs/app/docs/devbox_examples/languages/elixir.md b/docs/app/docs/devbox_examples/languages/elixir.md
index dcd2f514fd3..50315e148f3 100644
--- a/docs/app/docs/devbox_examples/languages/elixir.md
+++ b/docs/app/docs/devbox_examples/languages/elixir.md
@@ -2,7 +2,7 @@
 title: Elixir
 ---
 
-Elixir can be configured to install Hex and Rebar dependencies in a local directory. This will keep Elixir from trying to install in your immutable Nix Store: 
+Elixir can be configured to install Hex and Rebar dependencies in a local directory. This will keep Elixir from trying to install in your immutable Nix Store:
 
 [**Example Repo**](https://github.com/jetpack-io/devbox/tree/main/examples/development/elixir/elixir_hello)
 
@@ -15,18 +15,12 @@ Elixir can be configured to install Hex and Rebar dependencies in a local direct
 
 ```json
     "packages": [
-        "elixir",
-        "bash"
+        "elixir@latest",
+        "bash@latest"
     ],
 ```
 
-This will install Elixir 1.13. 
-Other versions available include: 
-
-* elixir_1_10 (version 1.10)
-* elixir_1_11 (version 1.11)
-* elixir_1_12 (version 1.12)
-* elixir_1_14 (version 1.14)
+This will install the latest version of Elixir available. You can find other installable versions of Elixir by running `devbox search elixir`.
 
 ## Installing Hex and Rebar locally
 
@@ -46,4 +40,4 @@ Since you are unable to install Elixir Deps directly into the Nix store, you wil
     }
 ```
 
-This will create local folders and force mix to install your Hex and Rebar packages to those folders. Now when you are in `devbox shell`, you can install using `mix deps`.
\ No newline at end of file
+This will create local folders and force mix to install your Hex and Rebar packages to those folders. Now when you are in `devbox shell`, you can install using `mix deps`.
diff --git a/docs/app/docs/devbox_examples/languages/fsharp.md b/docs/app/docs/devbox_examples/languages/fsharp.md
index c09575154a3..2131f04dfdd 100644
--- a/docs/app/docs/devbox_examples/languages/fsharp.md
+++ b/docs/app/docs/devbox_examples/languages/fsharp.md
@@ -14,17 +14,11 @@ F# and .NET projects can be easily generated in Devbox by adding the dotnet SDK
 
 ```json
   "packages": [
-    "dotnet-sdk"
+    "dotnet-sdk@latest"
   ],
 ```
-This will install .NET SDK 6.0
-
-Other versions available include: 
-
-* dotnet-sdk_7 (version 7.0)
-* dotnet-sdk_5 (version 5.0)
-* dotnet-sdk_3 (version 3.1)
+This will install the latest version of the dotnet SDK. You can find other installable versions of the dotnet SDK by running `devbox search dotnet-sdk`.
 
 ## Creating a new F# Project
 
-`dotnet new console -lang "F#" -o <name>`
\ No newline at end of file
+`dotnet new console -lang "F#" -o <name>`
diff --git a/docs/app/docs/devbox_examples/languages/go.md b/docs/app/docs/devbox_examples/languages/go.md
index 7ea3f97a519..6e518412108 100644
--- a/docs/app/docs/devbox_examples/languages/go.md
+++ b/docs/app/docs/devbox_examples/languages/go.md
@@ -14,23 +14,17 @@ Go projects can be run in Devbox by adding the Go SDK to your project. If your p
 
 ```json
   "packages": [
-    "go"
+    "go@latest"
   ]
 ```
 
-This will install go 1.18. 
+This will install the latest version of the Go SDK. You can find other installable versions of Go by running `devbox search go`.
 
-Other versions available to install include: 
-
-  * `go_1_19` (version 1.19)
-  * `go_1_17` (version 1.17)
-  
-
-If you need additional C libraries, you can add them along with `gcc` to your package list. For example, if libcap is required for yoru project: 
+If you need additional C libraries, you can add them along with `gcc` to your package list. For example, if libcap is required for yoru project:
 
 ```json
 "packages": [
     "go",
-    "gcc", 
+    "gcc",
     "libcap"
 ]
diff --git a/docs/app/docs/devbox_examples/languages/haskell.md b/docs/app/docs/devbox_examples/languages/haskell.md
index ff1acd43ef5..5353c8aa6f5 100644
--- a/docs/app/docs/devbox_examples/languages/haskell.md
+++ b/docs/app/docs/devbox_examples/languages/haskell.md
@@ -14,11 +14,11 @@ Haskell projects that use the Stack Framework can be run in Devbox by adding the
 
 ```json
   "packages": [
-    "stack",
-    "cabal-install",
-    "zlib",
-    "hpack"
+    "stack@latest",
+    "cabal-install@latest",
+    "zlib@latest",
+    "hpack@latest"
   ]
 ```
 
-This will install GHC, and the Haskell Tool Stack in your Devbox Shell.
\ No newline at end of file
+This will install GHC, and the Haskell Tool Stack in your Devbox Shell at their latest version. You can find other installable versions of Stack by running `devbox search <pkg>`.
diff --git a/docs/app/docs/devbox_examples/languages/java.md b/docs/app/docs/devbox_examples/languages/java.md
index 86421516893..9731b6076a0 100644
--- a/docs/app/docs/devbox_examples/languages/java.md
+++ b/docs/app/docs/devbox_examples/languages/java.md
@@ -2,9 +2,9 @@
 title: Java
 ---
 
-In addition to installing the JDK, you'll need to install either the Maven or Gradle build systems in your shell. 
+In addition to installing the JDK, you'll need to install either the Maven or Gradle build systems in your shell.
 
-In both cases, you'll want to first activate `devbox shell` before generating your Maven or Gradle projects, so that the tools use the right version of the JDK for creating your project. 
+In both cases, you'll want to first activate `devbox shell` before generating your Maven or Gradle projects, so that the tools use the right version of the JDK for creating your project.
 
 [**Example Repo**](https://github.com/jetpack-io/devbox/tree/main/examples/development/java)
 
@@ -14,17 +14,13 @@ In both cases, you'll want to first activate `devbox shell` before generating yo
 
 ```json
   "packages": [
-    "jdk",
-    "binutils"
+    "jdk@latest",
+    "binutils@latest"
   ],
 
 ```
 
-This will install the OpenJDK version 19. Other versions available include: 
-
-* jdk8 (OpenJDK 8)
-* jdk11 (OpenJDK 11)
-* jdk17 (OpenJDK 17)
+This will install the latest version of the JDK. To find other installable versions of the JDK, run `devbox search jdk`.
 
 Other distributions of the JDK (such as OracleJDK and Eclipse Temurin) are available in Nixpkgs, and can be found using [NixPkg Search](https://search.nixos.org/packages?channel=22.05&from=0&size=50&sort=relevance&type=packages&query=jdk#)
 
@@ -34,7 +30,7 @@ Other distributions of the JDK (such as OracleJDK and Eclipse Temurin) are avail
 
 [![Open In Devbox.sh](https://jetpack.io/img/devbox/open-in-devbox.svg)](https://devbox.sh/github.com/jetpack-io/devbox?folder=examples/development/java/gradle/hello-world)
 
-Gradle is a popular, multi-language build tool that is commonly used with JVM projects. To setup an example project using Gradle, follow the instructions below: 
+Gradle is a popular, multi-language build tool that is commonly used with JVM projects. To setup an example project using Gradle, follow the instructions below:
 
 1. Create a project folder: `my-project/` and call `devbox init` inside it. Then add these packages: `devbox add jdk` and `devbox add gradle`.
     - Replace `jdk` with the version of JDK you want. Get the exact nix-pkg name from `search.nixos.org`.
@@ -110,4 +106,4 @@ An example `devbox.json` would look like the following:
     "init_hook": null
   }
 }
-```
\ No newline at end of file
+```
diff --git a/docs/app/docs/devbox_examples/languages/nim.md b/docs/app/docs/devbox_examples/languages/nim.md
index a41575eb70e..50997dce4a9 100644
--- a/docs/app/docs/devbox_examples/languages/nim.md
+++ b/docs/app/docs/devbox_examples/languages/nim.md
@@ -14,10 +14,10 @@ Nim projects can be run in Devbox by adding Nim and Nimble to your project. For
 
 ```json
     "packages": [
-        "nim",
-        "nimble-unwrapped",
-        "openssl_1_1"
+        "nim@latest",
+        "nimble-unwrapped@latest",
+        "openssl_1_1@latest"
     ]
 ```
 
-This will install Nim 1.6.8. 
+This will install the latest version of Nim available. You can find other installable versions of Nim by running `devbox search nim`.
diff --git a/docs/app/docs/devbox_examples/languages/nodejs.md b/docs/app/docs/devbox_examples/languages/nodejs.md
index bf11f85030c..81e9127f3a5 100644
--- a/docs/app/docs/devbox_examples/languages/nodejs.md
+++ b/docs/app/docs/devbox_examples/languages/nodejs.md
@@ -14,16 +14,11 @@ Most NodeJS Projects will install their dependencies locally using NPM or Yarn,
 `devbox add nodejs`, or in your `devbox.json`:
 ```json
   "packages": [
-    "nodejs"
+    "nodejs@18"
   ],
 ```
 
-This will install NodeJS 18, and comes bundled with `npm`. 
-
-Other versions available include: 
-
-* `nodejs-16_x` (NodeJS 16)
-* `nodejs-19_x` (NodeJS 19)
+This will install NodeJS 18, and comes bundled with `npm`. You can find other installable versions of NodeJS by running `devbox search nodejs`.
 
 ## Adding Yarn as your Package Manager
 
@@ -31,26 +26,26 @@ Other versions available include:
 
 [![Open In Devbox.sh](https://jetpack.io/img/devbox/open-in-devbox.svg)](https://devbox.sh/github.com/jetpack-io/devbox?folder=examples/development/nodejs/nodejs-yarn)
 
-`devbox add yarn`, or in your `devbox.json` add: 
+`devbox add yarn`, or in your `devbox.json` add:
 ```json
   "packages": [
-    "nodejs",
-    "yarn"
+    "nodejs@18",
+    "yarn@latest"
   ],
 ```
 
 ## Installing Global Packages
 
-In some situations, you may want to install packages using `npm install --global`. This will fail in Devbox since the Nix Store is immutable. 
+In some situations, you may want to install packages using `npm install --global`. This will fail in Devbox since the Nix Store is immutable.
 
-You can instead install these global packages by adding them to the list of packages in your `devbox.json`. For example: to add `yalc` and `pm2`: 
+You can instead install these global packages by adding them to the list of packages in your `devbox.json`. For example: to add `yalc` and `pm2`:
 
 ```json
 {
     "packages": [
-        "nodejs",
-        "nodePackages.yalc",
-        "nodePackages.pm2"
+        "nodejs@18",
+        "nodePackages.yalc@latest",
+        "nodePackages.pm2@latest"
     ]
 }
-```
\ No newline at end of file
+```
diff --git a/docs/app/docs/devbox_examples/languages/php.md b/docs/app/docs/devbox_examples/languages/php.md
index b5e01986447..9f29c6ae126 100644
--- a/docs/app/docs/devbox_examples/languages/php.md
+++ b/docs/app/docs/devbox_examples/languages/php.md
@@ -2,7 +2,7 @@
 title: PHP
 ---
 
-PHP projects can manage most of their dependencies locally with `composer`. Some PHP extensions, however, need to be bundled with PHP at compile time. 
+PHP projects can manage most of their dependencies locally with `composer`. Some PHP extensions, however, need to be bundled with PHP at compile time.
 
 [**Example Repo**](https://github.com/jetpack-io/devbox/tree/main/examples/development/php/php8.1)
 
@@ -10,30 +10,24 @@ PHP projects can manage most of their dependencies locally with `composer`. Some
 
 ## Adding PHP to your Project
 
-Run `devbox add php php80Packages.composer`, or add the following to your `devbox.json`:
+Run `devbox add php php81Packages.composer`, or add the following to your `devbox.json`:
 
 ```json
     "packages": [
-        "php",
-        "php81Packages.composer
+        "php@8.1",
+        "php81Packages.composer@latest
     ]
 ```
-This will install PHP 8.1 in your shell. 
-
-Other versions available include: 
-
-* `php80` (PHP 8.0)
-* `php82` (PHP 8.2)
 
 ## Installing PHP Extensions
 
-You can compile additional extensions into PHP by adding them to `packages` in your `devbox.json`. Devbox will automatically ensure that your extensions are included in PHP at compile time. 
+You can compile additional extensions into PHP by adding them to `packages` in your `devbox.json`. Devbox will automatically ensure that your extensions are included in PHP at compile time.
 
-For example -- to add the `ds` extension, run `devbox add php81Extensions.ds`, or update your packages to include the following: 
+For example -- to add the `ds` extension, run `devbox add php81Extensions.ds`, or update your packages to include the following:
 
 ```json
     "packages": [
-        "php",
+        "php@8.1",
         "php81Packages.composer",
         "php81Extensions.ds"
     ]
@@ -41,23 +35,31 @@ For example -- to add the `ds` extension, run `devbox add php81Extensions.ds`, o
 
 ## PHP Plugin Details
 
-The PHP Plugin will provide the following configuration when you install a PHP runtime with `devbox add`
+The PHP Plugin will provide the following configuration when you install a PHP runtime with `devbox add`. You can also manually add the PHP plugin by adding `plugin:php` to your `includes` list in `devbox.json`:
+
+```json
+    "includes": [
+        "plugin:php"
+    ]
+```
 
 ### Services
 * php-fpm
 
 Use `devbox services start|stop php-fpm` to start PHP-FPM in the background.
 
-### Helper Files
-
-* {PROJECT_DIR}/devbox.d/php81/php-fpm.conf
-
-You can modify this file to configure your PHP-FPM server
-
 ### Environment Variables
 
 ```bash
 PHPFPM_PORT=8082
-PHPFPM_ERROR_LOG_FILE={PROJECT_DIR}/.devbox/virtenv/php81/php-fpm.log
-PHPFPM_PID_FILE={PROJECT_DIR}/.devbox/virtenv/php81/php-fpm.log
-```
\ No newline at end of file
+PHPFPM_ERROR_LOG_FILE={PROJECT_DIR}/.devbox/virtenv/php/php-fpm.log
+PHPFPM_PID_FILE={PROJECT_DIR}/.devbox/virtenv/php/php-fpm.log
+PHPRC={PROJECT_DIR}/devbox.d/php/php.ini
+```
+
+### Helper Files
+
+* {PROJECT_DIR}/devbox.d/php81/php-fpm.conf
+* {PROJECT_DIR}/devbox.d/php81/php.ini
+
+You can modify these file to configure PHP or your PHP-FPM server
diff --git a/docs/app/docs/devbox_examples/languages/python.md b/docs/app/docs/devbox_examples/languages/python.md
index 9f57a10aa25..b7f2182ddc0 100644
--- a/docs/app/docs/devbox_examples/languages/python.md
+++ b/docs/app/docs/devbox_examples/languages/python.md
@@ -8,23 +8,16 @@ Python by default will attempt to install your packages globally, or in the Nix
 
 ## Adding Python to your Project
 
-`devbox add python310`, or in your `devbox.json` add:
+`devbox add python@3.10`, or in your `devbox.json` add:
 
 
 ```json
   "packages": [
-    "python310"
+    "python@3.10"
   ],
 ```
 
-This will install Python 3.10 in your shell.
-
-Other versions available include: 
-
-* python37 (Python 3.7)
-* python38 (Python 3.8)
-* python39 (Python 3.9)
-* python311 (Python 3.11)
+This will install Python 3.10 in your shell. You can find other versions of Python by running `devbox search python`.
 
 ## Installing Packages with Pip
 
@@ -48,7 +41,7 @@ Your virtual environment is created in the `.devbox/virtenv/pip` directory by de
         "init_hook": ". $VENV_DIR/bin/activate"
     }
 }
-``` 
+```
 
 ## Pipenv
 
@@ -56,7 +49,7 @@ Your virtual environment is created in the `.devbox/virtenv/pip` directory by de
 
 [![Open In Devbox.sh](https://jetpack.io/img/devbox/open-in-devbox.svg)](https://devbox.sh/github.com/jetpack-io/devbox?folder=examples/development/python/pipenv)
 
-[pipenv](https://pipenv.pypa.io/en/latest/) is a tool that will automatically set up a virtual environment for installing your PyPi packages. 
+[pipenv](https://pipenv.pypa.io/en/latest/) is a tool that will automatically set up a virtual environment for installing your PyPi packages.
 
 You can install `pipenv` by adding it to the packages in your `devbox.json`. You can then manage your packages and virtual environment via a Pipfile
 
@@ -79,7 +72,7 @@ This init_hook will automatically start your virtualenv when you run `devbox she
 
 [![Open In Devbox.sh](https://jetpack.io/img/devbox/open-in-devbox.svg)](https://devbox.sh/github.com/jetpack-io/devbox?folder=examples/development/python/poetry/poetry-demo)
 
-[Poetry](https://python-poetry.org/) is a packaging and dependency manager for Python that helps you manage your Python packages, and can automatically create a virtual environment for your project. 
+[Poetry](https://python-poetry.org/) is a packaging and dependency manager for Python that helps you manage your Python packages, and can automatically create a virtual environment for your project.
 
 You can install Poetry by adding it to the packages in your `devbox.json`. You can then manage your packages and virtual environment via a `pyproject.toml`
 
@@ -94,4 +87,4 @@ You can install Poetry by adding it to the packages in your `devbox.json`. You c
     }
 }
 ```
-This init_hook will automatically start Poetry's virtualenv when you run `devbox shell`, and provide you with access to all your packages
\ No newline at end of file
+This init_hook will automatically start Poetry's virtualenv when you run `devbox shell`, and provide you with access to all your packages.
diff --git a/docs/app/docs/devbox_examples/languages/ruby.md b/docs/app/docs/devbox_examples/languages/ruby.md
index 10f927b9859..534533cf1ad 100644
--- a/docs/app/docs/devbox_examples/languages/ruby.md
+++ b/docs/app/docs/devbox_examples/languages/ruby.md
@@ -10,21 +10,16 @@ Ruby can be automatically configured by Devbox via the built-in Ruby Plugin. Thi
 
 ## Adding Ruby to your shell
 
-Run `devbox add ruby bundler`, or add the following to your `devbox.json`
+Run `devbox add ruby@3.1 bundler`, or add the following to your `devbox.json`
 
 ```json
     "packages": [
-        "ruby_3_1",
-        "bundler"
+        "ruby@3.1",
+        "bundler@latest"
     ]
 ```
 
-This will install Ruby 3.1 to your shell.
-
-Other versions available include:
-
-* `ruby` (Ruby 2.7)
-* `ruby_3_0` (Ruby 3.0)
+This will install Ruby 3.1 to your shell. You can find other installable versions of Ruby by running `devbox search ruby`.
 
 ## Ruby Plugin Support
 
diff --git a/docs/app/docs/devbox_examples/languages/rust.md b/docs/app/docs/devbox_examples/languages/rust.md
index 08fa917e038..e6733a76b39 100644
--- a/docs/app/docs/devbox_examples/languages/rust.md
+++ b/docs/app/docs/devbox_examples/languages/rust.md
@@ -2,7 +2,7 @@
 title: Rust
 ---
 
-The easiest way to manage Rust with Devbox is to install `rustup`, and then configure the channel you wish to install via Devbox's `init_hook`. You can also use the `init_hook` to configure `rustup` to install the Rust toolchain locally. 
+The easiest way to manage Rust with Devbox is to install `rustup`, and then configure the channel you wish to install via Devbox's `init_hook`. You can also use the `init_hook` to configure `rustup` to install the Rust toolchain locally.
 
 [**Example Repo**](https://github.com/jetpack-io/devbox/tree/main/examples/development/rust)
 
@@ -11,8 +11,8 @@ The easiest way to manage Rust with Devbox is to install `rustup`, and then conf
 ```json
 {
     "packages": [
-        "rustup",
-        "libiconv"
+        "rustup@latest",
+        "libiconv@latest"
     ],
     "shell": {
         "init_hook": [
@@ -33,4 +33,4 @@ The easiest way to manage Rust with Devbox is to install `rustup`, and then conf
 }
 ```
 
-To pin a specific version of Rust with Rustup, you can add a [rust-toolchain.toml](https://rust-lang.github.io/rustup/overrides.html#the-toolchain-file) and check it into source control.
\ No newline at end of file
+To pin a specific version of Rust with Rustup, you can add a [rust-toolchain.toml](https://rust-lang.github.io/rustup/overrides.html#the-toolchain-file) and check it into source control.
diff --git a/docs/app/docs/devbox_examples/languages/zig.md b/docs/app/docs/devbox_examples/languages/zig.md
index 29a3ddb36f3..236128b94be 100644
--- a/docs/app/docs/devbox_examples/languages/zig.md
+++ b/docs/app/docs/devbox_examples/languages/zig.md
@@ -14,8 +14,8 @@ Zig projects can be run in Devbox by adding Zig and Nimble to your project.
 
 ```json
     "packages": [
-        "zig",
+        "zig@latest",
     ]
 ```
 
-This will install Zig 0.9.1. 
+This will install the latest version of Zig. You can find other installable versions of Zig by running `devbox search zig`.
diff --git a/docs/app/docs/devbox_examples/servers/apache.md b/docs/app/docs/devbox_examples/servers/apache.md
index 00b26772d65..70eeebb24f3 100644
--- a/docs/app/docs/devbox_examples/servers/apache.md
+++ b/docs/app/docs/devbox_examples/servers/apache.md
@@ -10,14 +10,16 @@ Apache can be automatically configured by Devbox via the built-in Apache Plugin.
 
 ### Adding Apache to your Shell
 
-Run `devbox add apacheHttpd`, or add the following to your `devbox.json`
+Run `devbox add apache`, or add the following to your `devbox.json`
 
 ```json
   "packages": [
-    "apacheHttpd"
+    "apache@latest"
   ]
 ```
 
+This will install the latest version of Apache. You can find other installable versions of Apache by running `devbox search apache`.
+
 ## Apache Plugin Details
 
 The Apache plugin will automatically create the following configuration when you install Apache with `devbox add`
@@ -45,4 +47,4 @@ HTTPD_CONFDIR={PROJECT_DIR}/devbox.d/apacheHttpd
 
 ### Notes
 
-We recommend copying your `httpd.conf` file to a new directory and updating HTTPD_CONFDIR if you decide to modify it.
\ No newline at end of file
+We recommend copying your `httpd.conf` file to a new directory and updating HTTPD_CONFDIR if you decide to modify it.
diff --git a/docs/app/docs/devbox_examples/servers/caddy.md b/docs/app/docs/devbox_examples/servers/caddy.md
index b3cd20b393c..6b3f9fb7a6d 100644
--- a/docs/app/docs/devbox_examples/servers/caddy.md
+++ b/docs/app/docs/devbox_examples/servers/caddy.md
@@ -14,10 +14,12 @@ Run `devbox add caddy`, or add the following to your `devbox.json`
 
 ```json
   "packages": [
-    "caddy"
+    "caddy@latest"
   ]
 ```
 
+This will install the latest version of Caddy. You can find other installable versions of Caddy by running `devbox search caddy`.
+
 ## Caddy Plugin Details
 
 The Caddy plugin will automatically create the following configuration when you install Caddy with `devbox add`
@@ -44,4 +46,4 @@ Note that by default, Caddy is configured with `./devbox.d/web` as the root. To
 
 ### Notes
 
-You can customize the config used by the caddy service by modifying the Caddyfile in devbox.d/caddy, or by changing the CADDY_CONFIG environment variable to point to a custom config. The custom config must be either JSON or Caddyfile format.
\ No newline at end of file
+You can customize the config used by the caddy service by modifying the Caddyfile in devbox.d/caddy, or by changing the CADDY_CONFIG environment variable to point to a custom config. The custom config must be either JSON or Caddyfile format.
diff --git a/docs/app/docs/devbox_examples/servers/nginx.md b/docs/app/docs/devbox_examples/servers/nginx.md
index 27612d579b2..8e79bf5ef33 100644
--- a/docs/app/docs/devbox_examples/servers/nginx.md
+++ b/docs/app/docs/devbox_examples/servers/nginx.md
@@ -14,10 +14,12 @@ Run `devbox add nginx`, or add the following to your `devbox.json`
 
 ```json
   "packages": [
-    "nginx"
+    "nginx@latest"
   ]
 ```
 
+This will install the latest version of NGINX. You can find other installable versions of NGINX by running `devbox search nginx`.
+
 ## NGINX Plugin Details
 
 ### Services
@@ -53,4 +55,4 @@ To customize:
 * Use $NGINX_TMPDIR to change the tmp directory. Use $NGINX_USER to change the user
 * Use $NGINX_GROUP to customize.
 
-You can also customize the `nginx.conf` and `fastcgi.conf` stored in `devbox.d/nginx`
\ No newline at end of file
+You can also customize the `nginx.conf` and `fastcgi.conf` stored in `devbox.d/nginx`
diff --git a/docs/app/docs/guides/pinning_packages.md b/docs/app/docs/guides/pinning_packages.md
index 7688d9eb191..9aacf17385e 100644
--- a/docs/app/docs/guides/pinning_packages.md
+++ b/docs/app/docs/guides/pinning_packages.md
@@ -53,15 +53,15 @@ When you run a command that installs your packages (like `devbox shell` or `devb
 If you want to update your packages, you can run `devbox update`. This command will update all your pinned packages to the newest compatible version in the Devbox index.
 
 ### Using the Latest Version of a Package
-If you do not include a version string, Devbox will default to using the latest available version of a package in the Nixpkgs commit pinned in your `devbox.json`.
+If you do not include a version string, Devbox will default to using the latest available version of the package in our Nixpkg index. This is the same as adding `<pkg>@<latest>` to your devbox.json.
 
-To ensure you use the latest available package, you can run `devbox add <pkg>@latest` or adding `package@latest` to the package list in your devbox.json. For example, to use the latest version of `ripgrep,` run `devbox add ripgrep@latest` or add `ripgrep@latest` to your devbox.json.
+For example, to use the latest version of `ripgrep,` run `devbox add ripgrep`, `devbox add ripgrep@latest`, or add `ripgrep@latest` to your devbox.json package list.
 
-Whenever you run `devbox update`, your package will be updated to the latest version available in our index.
+Whenever you run `devbox update`, packages with the latest tag will be updated to the latest version available in our index.
 
-## Manually Pinning a Nixpkg Commit for a Single Package
+## Manually Pinning a Nixpkg Commit for a Package
 
-If you want to use a different commit for a single package, you can use a Flake reference to use an older revision of Nixpkg for just that package. The example below shows how to install the `hello` package from a specific Nixpkg commit:
+If you want to use a specific Nixpkg revision for a package, you can use a `github:nixos/nixpkgs/<commit_sha>#<pkg>` Flake reference. The example below shows how to install the `hello` package from a specific Nixpkg commit:
 
 ```json
 }
@@ -74,6 +74,10 @@ Using multiple nixpkg commits may install duplicate packages and cause Nix Store
 
 ## Pinning the Default Nixpkg commit in your Devbox.json
 
+:::caution
+Pinning the nixpkgs commit is considered deprecated starting with Devbox version 0.5.0, and will eventually be removed. We recommend using the `@` syntax to pin specific package versions instead.
+:::
+
 Devbox stores a default Nixpkg commit in your project's `devbox.json`, under the `nixpkgs.commit`. If you do not provide one yourself, Devbox will automatically add a default commit when you run a command like `devbox add`, `devbox shell`, or `devbox run`:
 
 ```json
diff --git a/docs/app/docs/guides/plugins.md b/docs/app/docs/guides/plugins.md
index 29caf1983af..dd140e2e0f1 100644
--- a/docs/app/docs/guides/plugins.md
+++ b/docs/app/docs/guides/plugins.md
@@ -9,13 +9,14 @@ If a plugin is available for your package, it will activate when you install the
 ## Current Plugins
 Plugins are available for the following packages. You can activate the plugins for these packages by running `devbox add <package_name>`:
 * [Apache](../devbox_examples/servers/apache.md) (apacheHttpd)
-* [Nginx](../devbox_examples/servers/nginx.md) (nginx)
 * [Caddy](../devbox_examples/servers/caddy.md) (caddy)
+* [Nginx](../devbox_examples/servers/nginx.md) (nginx)
+* [MariaDB](../devbox_examples/databases/mariadb.md) (mariadb, mariadb_10_6...)
 * [PostgreSQL](../devbox_examples/databases/postgres.md) (postgresql)
 * [Redis](../devbox_examples/databases/redis.md) (redis)
-* [PHP](../devbox_examples/languages/php.md) (php, php80, php81, php82)
-* [Ruby](../devbox_examples/languages/ruby.md)(ruby, ruby_3_1, ruby_3_0)
-* [Pip](../devbox_examples/languages/python.md) (python39Packages.pip, python310Packages.pip, python311Packages.pip)
+* [PHP](../devbox_examples/languages/php.md) (php, php80, php81, php82...)
+* [Pip](../devbox_examples/languages/python.md) (python39Packages.pip, python310Packages.pip, python311Packages.pip...)
+* [Ruby](../devbox_examples/languages/ruby.md)(ruby, ruby_3_1, ruby_3_0...)
 
 Our team is rapidly adding new plugins to Devbox. If you want to request a plugin, please file an issue in the Devbox Repo.