Guide

The ins and outs of Rocket, in detail.

warning icon This version is in development. Go to current release. warning icon

Quickstart

Before you can start writing a Rocket application, you'll need to install the Rust toolchain. We recommend using rustup. If you don't have Rust installed and would like extra guidance doing so, see Getting Started.

Running Examples

The absolute fastest way to start experimenting with Rocket is to clone the Rocket repository and run the included examples in the examples/ directory. For instance, the following set of commands runs the hello example:

1
2
3
4
5
git clone https://github.com/rwf2/Rocket
cd Rocket
git checkout master
cd examples/hello
cargo run

There are numerous examples in the examples/ directory. They can all be run with cargo run.

The examples' Cargo.toml files will point to the locally cloned rocket libraries. When copying the examples for your own use, you should modify the Cargo.toml files as explained in the Getting Started guide.