Quick Start

Get Atomic Reactor running in a few minutes.

Prerequisites

• Rust 1.88+ — install via rustup: curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
• Docker & Docker Compose — for PostgreSQL and Redis
• Node.js 20+ — for frontend development

Install and run

# Clone the repository
git clone https://github.com/atomicjolt/atomic-forge.git
cd atomic-forge/atomic-reactor

# Set up environment
cp .env.example .env
# Edit .env with your configuration — see the Configuration guide

# Recommended: complete setup (installs Rust/Node tools, starts PostgreSQL/Redis,
# creates the database, runs migrations, seeds data)
make setup

# Start the development server
make dev

Once the server is running you can reach it at:

• API / backend: http://localhost:8080
• Frontend (with hot reload): http://localhost:5173

First steps

1. Open the application at http://localhost:8080.
2. Set up an admin using the bootstrap admin feature (BOOTSTRAP_ADMIN_EMAILS in your .env).
3. Create a course from the course management interface.
4. Try an integration — configure an LTI tool and test the launch flow.

Explore the API

• Browse every endpoint in the API Reference.
• Try requests interactively in the API Explorer.

Next steps

• Installation — detailed setup for development and production.
• Configuration — environment variables and security keys.
• Integration guides — connect LTI, SSO, Google Classroom, Canvas, and D2L.

Troubleshooting

If something isn’t working:

1. Check that the service containers are running: docker-compose ps.
2. Verify database connectivity: make db-console.
3. Review the logs: docker-compose logs -f.