shuttle-hq · jonaro00 · Jul 23, 2024 · Jul 22, 2024 · Jul 22, 2024 · Jul 22, 2024
diff --git a/configuration/environment.mdx b/configuration/environment.mdx
@@ -14,7 +14,7 @@ This page answers:
 
 Deployments are currently built and run in our `shuttle-deployer` container, which is based on a Rust Bookworm docker image (Debian 12).
 
-The current Rust version is `1.75.0`, toolchain `stable-x86_64-unknown-linux-gnu`.
+The current Rust version is `1.79.0`, toolchain `stable-x86_64-unknown-linux-gnu`.
 It's not currently possible for you to change this, but being able to choose which toolchain your project will be compiled with is a planned feature.
 
 The target `wasm32-unknown-unknown` is installed, which enables compiling WASM frontends.
@@ -41,12 +41,12 @@ Additionally, these tools are installed:
 ## Environment variables
 
 There are some environment variables set in the Shuttle container.
-Check for `SHUTTLE=true` for custom behavior when running on Shuttle.
+Check for `SHUTTLE=true` or use [the shuttle feature flag](./project-structure#cargo-feature-flags) for custom behavior when running on Shuttle.
 
 ```bash
 SHUTTLE=true
-RUST_VERSION="1.75.0"
-RUSTUP_TOOLCHAIN="1.75.0"
+RUST_VERSION="1.79.0"
+RUSTUP_TOOLCHAIN="1.79.0"
 ```
 
 ### Build environment
@@ -69,6 +69,12 @@ rustflags = ["-C", "link-arg=-fuse-ld=/usr/bin/ld.lld"]
 
 See [Shuttle Secrets](/resources/shuttle-secrets)
 
+## Multiple environments
+
+Multiple environments (such as development, staging and production) within a project is a planned feature.
+Until that feature is ready, you can use a workflow of using one Shuttle project for each environment (for example `project` and `project-dev`).
+To deploy to the non-default project name, you can use the `deploy` command with `--name` for targetting a different project, and `--secrets` to use a different secrets file.
+
 ## Limitations
 
 <Warning>

diff --git a/configuration/files.mdx b/configuration/files.mdx
@@ -45,6 +45,12 @@ You can double check which files are included in your deployment by turning on d
 cargo shuttle --debug deploy
 ```
 
+or inspect the archive after writing it to disk:
+
+```bash
+cargo shuttle deploy --output-archive deployment.tar
+```
+
 ## Serving static files
 
 Serving a web project often means that there are static HTML, CSS, or JavaScript files to serve.

diff --git a/configuration/shuttle-versions.mdx b/configuration/shuttle-versions.mdx
@@ -21,7 +21,7 @@ Combining all of the above, these are the recommended steps for upgrading a Shut
 
 2. Update your project's `shuttle-...` dependencies in `Cargo.toml`:
    ```toml Cargo.toml
-   shuttle-runtime = "0.46.0"
+   shuttle-runtime = "0.47.0"
    # etc
    ```
 

diff --git a/examples/actix-postgres.mdx b/examples/actix-postgres.mdx
@@ -117,10 +117,10 @@ edition = "2021"
 
 [dependencies]
 actix-web = "4.3.1"
-shuttle-actix-web = "0.46.0"
-shuttle-runtime = "0.46.0"
+shuttle-actix-web = "0.47.0"
+shuttle-runtime = "0.47.0"
 serde = "1.0.148"
-shuttle-shared-db = { version = "0.46.0", features = ["postgres", "sqlx"] }
+shuttle-shared-db = { version = "0.47.0", features = ["postgres", "sqlx"] }
 sqlx = "0.7.1"
 tokio = "1.26.0"
 ```

diff --git a/examples/actix-websocket-actorless.mdx b/examples/actix-websocket-actorless.mdx
@@ -407,8 +407,8 @@ futures = "0.3"
 reqwest = "0.11"
 serde = { version = "1.0", features = ["derive"] }
 serde_json = "1.0"
-shuttle-actix-web = "0.46.0"
-shuttle-runtime = "0.46.0"
+shuttle-actix-web = "0.47.0"
+shuttle-runtime = "0.47.0"
 tokio = { version = "1", features = ["rt-multi-thread", "sync"] }
 tracing = "0.1"
 ```

diff --git a/examples/actix.mdx b/examples/actix.mdx
@@ -45,8 +45,8 @@ edition = "2021"
 
 [dependencies]
 actix-web = "4.3.1"
-shuttle-actix-web = "0.46.0"
-shuttle-runtime = "0.46.0"
+shuttle-actix-web = "0.47.0"
+shuttle-runtime = "0.47.0"
 tokio = "1.26.0"
 ```
 </CodeGroup>

diff --git a/examples/axum-jwt-authentication.mdx b/examples/axum-jwt-authentication.mdx
@@ -221,8 +221,8 @@ jsonwebtoken = "8.3.0"
 once_cell = "1.18.0"
 serde = { version = "1.0.188", features = ["derive"] }
 serde_json = "1.0.107"
-shuttle-axum = "0.46.0"
-shuttle-runtime = "0.46.0"
+shuttle-axum = "0.47.0"
+shuttle-runtime = "0.47.0"
 tokio = "1.28.2"
 tracing-subscriber = "0.3.17"
 ```

diff --git a/examples/axum-postgres.mdx b/examples/axum-postgres.mdx
@@ -102,9 +102,9 @@ edition = "2021"
 [dependencies]
 axum = "0.7.3"
 serde = { version = "1.0.188", features = ["derive"] }
-shuttle-axum = "0.46.0"
-shuttle-runtime = "0.46.0"
-shuttle-shared-db = { version = "0.46.0", features = ["postgres", "sqlx"] }
+shuttle-axum = "0.47.0"
+shuttle-runtime = "0.47.0"
+shuttle-shared-db = { version = "0.47.0", features = ["postgres", "sqlx"] }
 sqlx = "0.7.1"
 tokio = "1.28.2"
 ```

diff --git a/examples/axum-static-files.mdx b/examples/axum-static-files.mdx
@@ -58,8 +58,8 @@ publish = false
 
 [dependencies]
 axum = "0.7.3"
-shuttle-axum = "0.46.0"
-shuttle-runtime = "0.46.0"
+shuttle-axum = "0.47.0"
+shuttle-runtime = "0.47.0"
 tokio = "1.28.2"
 tower-http = { version = "0.5.0", features = ["fs"] }
 ```

diff --git a/examples/axum-websockets.mdx b/examples/axum-websockets.mdx
@@ -266,8 +266,8 @@ futures = "0.3.28"
 reqwest = "0.11.23"
 serde = { version = "1.0.163", features = ["derive"] }
 serde_json = "1.0.96"
-shuttle-axum = "0.46.0"
-shuttle-runtime = "0.46.0"
+shuttle-axum = "0.47.0"
+shuttle-runtime = "0.47.0"
 tokio = "1.28.2"
 tower-http = { version = "0.5.0", features = ["fs"] }
 ```

diff --git a/examples/axum.mdx b/examples/axum.mdx
@@ -43,8 +43,8 @@ edition = "2021"
 
 [dependencies]
 axum = "0.7.3"
-shuttle-axum = "0.46.0"
-shuttle-runtime = "0.46.0"
+shuttle-axum = "0.47.0"
+shuttle-runtime = "0.47.0"
 tokio = "1.28.2"
 ```
 </CodeGroup>

diff --git a/examples/poise.mdx b/examples/poise.mdx
@@ -72,9 +72,9 @@ publish = false
 [dependencies]
 anyhow = "1.0.68"
 poise = "0.6.1"
-shuttle-runtime = "0.46.0"
+shuttle-runtime = "0.47.0"
 # Since poise is a serenity command framework, it can run on Shuttle with shuttle-serenity
-shuttle-serenity = "0.46.0"
+shuttle-serenity = "0.47.0"
 tracing = "0.1.37"
 tokio = "1.26.0"
 ```

diff --git a/examples/rocket-jwt-authentication.mdx b/examples/rocket-jwt-authentication.mdx
@@ -38,8 +38,8 @@ jsonwebtoken = { version = "8.1.1", default-features = false }
 lazy_static = "1.4.0"
 rocket = { version = "0.5.0", features = ["json"] }
 serde = { version = "1.0.148", features = ["derive"] }
-shuttle-rocket = "0.46.0"
-shuttle-runtime = "0.46.0"
+shuttle-rocket = "0.47.0"
+shuttle-runtime = "0.47.0"
 tokio = "1.26.0"
 ```
 Your `main.rs` should look like this:

diff --git a/examples/rocket-postgres.mdx b/examples/rocket-postgres.mdx
@@ -104,9 +104,9 @@ edition = "2021"
 [dependencies]
 rocket = { version = "0.5.0", features = ["json"] }
 serde = "1.0.148"
-shuttle-rocket = "0.46.0"
-shuttle-runtime = "0.46.0"
-shuttle-shared-db = { version = "0.46.0", features = ["postgres", "sqlx"] }
+shuttle-rocket = "0.47.0"
+shuttle-runtime = "0.47.0"
+shuttle-shared-db = { version = "0.47.0", features = ["postgres", "sqlx"] }
 sqlx = "0.7.1"
 tokio = "1.26.0"
 ```

diff --git a/examples/rocket-static-files.mdx b/examples/rocket-static-files.mdx
@@ -76,8 +76,8 @@ publish = false
 
 [dependencies]
 rocket = "0.5.0"
-shuttle-rocket = "0.46.0"
-shuttle-runtime = "0.46.0"
+shuttle-rocket = "0.47.0"
+shuttle-runtime = "0.47.0"
 tokio = "1.26.0"
 ```
 

diff --git a/examples/rocket.mdx b/examples/rocket.mdx
@@ -43,8 +43,8 @@ edition = "2021"
 
 [dependencies]
 rocket = "0.5.0"
-shuttle-rocket = "0.46.0"
-shuttle-runtime = "0.46.0"
+shuttle-rocket = "0.47.0"
+shuttle-runtime = "0.47.0"
 tokio = "1.26.0"
 ```
 </CodeGroup>

diff --git a/examples/serenity-todo.mdx b/examples/serenity-todo.mdx
@@ -269,9 +269,9 @@ edition = "2021"
 anyhow = "1.0.66"
 serde = "1.0.148"
 serenity = { version = "0.12.0", default-features = false, features = ["client", "gateway", "rustls_backend", "model"] }
-shuttle-runtime = "0.46.0"
-shuttle-serenity = "0.46.0"
-shuttle-shared-db = { version = "0.46.0", features = ["postgres", "sqlx"] }
+shuttle-runtime = "0.47.0"
+shuttle-serenity = "0.47.0"
+shuttle-shared-db = { version = "0.47.0", features = ["postgres", "sqlx"] }
 sqlx = "0.7.1"
 tokio = "1.26.0"
 tracing = "0.1.37"

diff --git a/examples/serenity.mdx b/examples/serenity.mdx
@@ -87,8 +87,8 @@ edition = "2021"
 [dependencies]
 anyhow = "1.0.66"
 serenity = { version = "0.12.0", default-features = false, features = ["client", "gateway", "rustls_backend", "model"] }
-shuttle-runtime = "0.46.0"
-shuttle-serenity = "0.46.0"
+shuttle-runtime = "0.47.0"
+shuttle-serenity = "0.47.0"
 tokio = "1.26.0"
 tracing = "0.1.37"
 ```

diff --git a/getting-started/installation.mdx b/getting-started/installation.mdx
@@ -43,8 +43,6 @@ Although a bit slower, you can also install directly with cargo:
 cargo install cargo-shuttle
 ```
 
-<Note>Installing cargo-shuttle from source requires Rust 1.75+. You can verify by running `cargo --version`.</Note>
-
 ### Distro packages (unofficial)
 
 `cargo-shuttle` is also packaged by community members for some distros:

diff --git a/getting-started/shuttle-commands.mdx b/getting-started/shuttle-commands.mdx
@@ -98,3 +98,8 @@ All project-related commands can use:
 Use `cargo shuttle generate shell <shell>` with one of: bash, elvish, fish, powershell, zsh.
 
 Example configuration for Zsh on Linux: add `eval "$(cargo shuttle generate shell zsh)"` to `~/.zshrc`.
+
+### Utility
+
+- `cargo shuttle --debug <command>`: Turn on tracing output for Shuttle libraries. (WARNING: can print sensitive data)
+- `cargo shuttle deploy --output-archive <path>`: Dump the deployment archive to disk instead of deploying it. Useful for debugging.
diff --git a/resources/custom-resources.mdx b/resources/custom-resources.mdx
@@ -91,9 +91,9 @@ edition = "2021"
 async-trait = "0.1.56"
 axum = "0.7.3"
 serde = { version = "1.0.148", default-features = false, features = ["derive"] }
-shuttle-service = "0.46.0"
-shuttle-axum = "0.46.0"
-shuttle-runtime = "0.46.0"
+shuttle-service = "0.47.0"
+shuttle-axum = "0.47.0"
+shuttle-runtime = "0.47.0"
 tokio = "1.28.2"
 ```
 </CodeGroup>
diff --git a/templates/tutorials/custom-service.mdx b/templates/tutorials/custom-service.mdx
@@ -48,7 +48,7 @@ axum = "0.6.4"
 hyper = "0.14.24"
 poise = "0.5.2"
 serde = "1.0"
-shuttle-runtime = "0.46.0"
+shuttle-runtime = "0.47.0"
 tokio = "1.26.0"
 ```
 

diff --git a/templates/tutorials/url-shortener.mdx b/templates/tutorials/url-shortener.mdx
@@ -129,8 +129,8 @@ edition = "2021"
 
 [dependencies]
 rocket = "0.5.0"
-shuttle-rocket = "0.46.0"
-shuttle-runtime = "0.46.0"
+shuttle-rocket = "0.47.0"
+shuttle-runtime = "0.47.0"
 tokio = "1.26.0"
 ```
 
@@ -152,8 +152,8 @@ $ cargo shuttle deploy
    Compiling rocket_http v0.5.0
    Compiling rocket_codegen v0.5.0
    Compiling rocket v0.5.0
-   Compiling shuttle-rocket v0.46.0
-   Compiling shuttle-runtime v0.46.0
+   Compiling shuttle-rocket v0.47.0
+   Compiling shuttle-runtime v0.47.0
    Compiling url-shortener v0.1.0 (/opt/shuttle/crates/url-shortener)
     Finished dev [unoptimized + debuginfo] target(s) in 1m 01s
 

diff --git a/templates/tutorials/websocket-chat-app-js.mdx b/templates/tutorials/websocket-chat-app-js.mdx
@@ -257,8 +257,8 @@ hyper = { version = "0.14", features = ["client", "http2"] }
 hyper-tls = "0.5"
 serde = { version = "1.0", features = ["derive"] }
 serde_json = "1.0"
-shuttle-axum = "0.46.0"
-shuttle-runtime = "0.46.0"
+shuttle-axum = "0.47.0"
+shuttle-runtime = "0.47.0"
 sync_wrapper = "0.1"
 tokio = { version = "1", features = ["full"] }
 tower-http = { version = "0.3.5", features = ["fs", "auth"]}