actixweb.comDocs & Learning Hub
Complete Curriculum • Updated for Actix 4.9 & Rust 2024

Actix Web Documentation

From your first App::new() to enterprise-scale SQLx connection pools, custom JWT middleware, and Distroless Docker deployments.

Start from Scratch Interactive Cheatsheet

1. Getting Started

4 Chapters

Foundational setup, installation, and your first production-ready Actix Web server.

Why Actix Web?
Explore the speed, type safety, and battle-tested ergonomics of Rust leading web framework.
4 min
Installation & Cargo Setup
Configure your Rust toolchain, Cargo.toml dependencies, and modern workspace layout.
5 min
Hello World & Server Basics
Build, compile, and run your very first async HTTP server with App and HttpServer.
6 min
Production Project Structure
Organize real-world apps into clean domain layers: handlers, models, repositories, and config.
7 min
Start section

2. Core Architecture

4 Chapters

Understand the inner threading model, Application factories, extractors, and responders.

HttpServer & Worker Threads
How Actix leverages multi-core CPU parallelism with thread-local async runtimes.
8 min
App State with web::Data<T>
Share database pools, configurations, and thread-safe caches across request handlers.
9 min
Handlers & impl Responder
Write clean async handler functions and construct type-safe HTTP responses.
6 min
Type-Safe Extractors
Master Path, Query, Json, Form, and Header extractors with automatic validation.
10 min
Start section

3. Routing & Payloads

3 Chapters

URL routing, dynamic parameters, JSON serialization, and streaming file transfers.

Dynamic Routing & Scopes
Group endpoints with web::scope, route guards, regex patterns, and path variables.
7 min
JSON Payloads & Serde
Process request bodies safely with custom JsonConfig size limits and error handlers.
8 min
File Serving & Streaming
Serve static assets with actix-files and stream large binary datasets without memory spikes.
7 min
Start section

4. State & Databases

3 Chapters

Integrate SQLx PostgreSQL, Diesel, and Redis for blazingly fast data persistence.

SQLx & PostgreSQL
Async connection pooling, compile-time query verification, transactions, and migrations.
11 min
Diesel ORM with web::block
Execute synchronous ORM queries safely on dedicated blocking thread pools.
8 min
Redis Caching LayerAdv
High-performance cache-aside patterns and session stores with async Redis.
9 min
Start section

5. Middleware & Security

3 Chapters

CORS, structured logging, JWT authentication guards, and rate limiting.

Logger, CORS & Compression
Configure production-grade middleware for access logs, CORS policies, and Gzip/Brotli.
6 min
Custom JWT Auth MiddlewareAdv
Build custom Transform & Service traits to validate Bearer tokens and attach AuthUser.
12 min
Rate Limiting & DoS ProtectionAdv
Protect your API endpoints from abuse using token bucket algorithms and governor.
8 min
Start section

6. WebSockets & Real-Time

2 Chapters

Build low-latency real-time applications with modern async WebSockets and SSE.

Async WebSockets (actix-ws)
Build bidirectional real-time communication without the legacy actor system overhead.
9 min
Server-Sent Events (SSE)
Stream live token responses, AI generation feeds, and dashboard updates via HTTP.
7 min
Start section

7. Testing & Quality Assurance

2 Chapters

Write rock-solid unit tests, test clients, and high-load stress testing suites.

Testing with actix_web::test
Unit test handlers and run fast in-memory integration tests with TestRequest.
8 min
Benchmarking 100k Req/SecAdv
Profile memory allocation, flamegraphs, and stress test endpoints using k6 and wrk.
10 min
Start section

8. Production & Deployment

2 Chapters

Containerize with multi-stage distroless Docker, Kubernetes probes, and graceful shutdown.

Ultra-Light Distroless Docker
Build ultra-secure ~15MB Docker containers using cargo-chef caching and Google Distroless.
9 min
Graceful Shutdown & Signal HandlingAdv
Handle SIGINT/SIGTERM cleanly, flush database pools, and complete pending requests.
7 min
Start section