Install the CLI. See the install docs.
Log in:
runway login
Add an SSH key. See key setup, or use the shortcut:
runway local key setup
Rust’s mdBook is a static site generator for documentation and book-like websites. Deploying your mdBook site on Runway is as easy as:
mdbook init my-book
cd my-book
runway app create
git add -A && git commit -m "initial commit"
runway app deploy
Run runway app open to see it live, or check the Runway UI. Check runway app logs if something’s off.
Run these commands inside your repository and Runway will build and deploy your website (with Nginx).
To use a specific mdBook version, set the following:
runway app config set BP_RUNWAY_STATIC_MDBOOK_VERSION=0.5.2
[build]
[[build.env]]
name = "BP_RUNWAY_STATIC_MDBOOK_VERSION"
value = "0.5.2"
Redeploy after changing this:
runway app deploy
To configure Nginx, add an nginx.conf file to the root of your repository with your server configuration. To see an example of what is needed, you can check out the web server config recipe.