11 releases

✓ Uses Rust 2018 edition

0.3.5-alpha Mar 21, 2020
0.3.4 Jan 29, 2020
0.3.1 Dec 2, 2019
0.3.0 Nov 13, 2019
0.1.4-alpha.1 Jul 27, 2019

#21 in Concurrency

Download history 80/week @ 2020-03-12 263/week @ 2020-03-19 147/week @ 2020-03-26 474/week @ 2020-04-02 406/week @ 2020-04-09 459/week @ 2020-04-16 312/week @ 2020-04-23 67/week @ 2020-04-30 220/week @ 2020-05-07 347/week @ 2020-05-14 659/week @ 2020-05-21 534/week @ 2020-05-28 212/week @ 2020-06-04 391/week @ 2020-06-11 720/week @ 2020-06-18 400/week @ 2020-06-25

725 downloads per month
Used in 3 crates


7.5K SLoC

Highly-available Distributed* Fault-tolerant Runtime

Latest Release Crates.io
License Crates.io
Doc [Bastion] Documentation (Bastion)
Doc [Bastion Executor] Documentation (Bastion Executor)
Doc [LightProc] Documentation (LightProc)
Build Status Build Status
Downloads Crates.io

Bastion is a highly-available, fault-tolerant runtime system with dynamic, dispatch-oriented, lightweight process model. It supplies actor-model-like concurrency with a lightweight process implementation and utilizes all of the system resources efficiently guaranteeing of at-most-once message delivery.

Please note that Bastion is not production-ready yet and might break some backward compatibility for now.


Bastion comes with a default one-for-one strategy root supervisor. You can use this to launch automatically supervised tasks.


  • Message-based communication makes this project a lean mesh of actor system.
    • Without web servers, weird shenanigans, forced trait implementations, and static dispatch.
  • Runtime fault-tolerance makes it a good candidate for distributed systems.
    • If you want the smell of Erlang and the powerful aspects of Rust. That's it!
  • Completely asynchronous runtime with NUMA-aware and cache-affine SMP executor.
    • Exploiting hardware locality wherever it is possible. It is designed for servers.
  • Supervision system makes it easy to manage lifecycles.
    • Kill your application in certain condition or restart you subprocesses whenever a certain condition is met.


  • At most once delivery for all messages.
  • Completely asynchronous system design.
  • Asynchronous program boundaries with fort.
  • Dynamic supervision of supervisors (adding a subtree later during the execution)
  • Lifecycle management both at futures and lightproc layers.
  • Faster middleware development.
  • Fault tolerance above all.

Why Bastion?

If you answer any of the questions below with yes, then Bastion is just for you:

  • Do I need fault-tolerance in my project?
  • Do I hate to implement weird Actor traits?
  • I shouldn't need a webserver to run an actor system, right?
  • Do I want to make my existing code unbreakable?
  • Do I have some trust issues with orchestration systems?
  • Do I want to implement my own application lifecycle?

Get Started

Check the getting started example in bastion/examples

Examples cover possible use cases of the crate.

Include bastion to your project with:

bastion = "0.3"

For more information please check Bastion Documentation

Architecture of the Runtime

Runtime is structured by the user. Only root supervision comes in batteries-included fashion. Worker code, worker group redundancy, supervisors and their supervision strategies are defined by the user.

You can see architecture of the framework HERE.

Projects using Bastion

If you are using Bastion open a PR so we can include it in our showcase.

  • SkyNet (a Discord bot which is resending deleted messages)
    • Skynet is running since 0.1.3 release of Bastion on the cloud and haven't killed yet.
  • In AWS Lambdas we have used Bastion to enable retry mechanism and try different parsing strategies for data to be processed.


Licensed under either of

at your option.


Official documentation is hosted on docs.rs.

Getting Help

Please head to our Discord or use StackOverflow

Discussion and Development

We use Discord for development discussions. Also please don't hesitate to open issues on GitHub ask for features, report bugs, comment on design and more! More interaction and more ideas are better!

Contributing to Bastion Open Source Helpers

All contributions, bug reports, bug fixes, documentation improvements, enhancements and ideas are welcome.

A detailed overview on how to contribute can be found in the CONTRIBUTING guide on GitHub.


FOSSA Status

FOSSA Status

* Currently, we are working on distributed properties and protocol.


~67K SLoC