Prerequisites
How to configure your development environment for JTBDOS.
Operating System
JTBDOS is designed to work on macOS, Linux and Windows. While JTBDOS itself is platform-agnostic, the tooling and dependencies we use have different requirements.
We’ve tested and confirmed that JTBDOS works on the following combinations of operating systems, Node.js versions and JTBDOS versions:
| Operating system | JTBDOS version | Node.js version | Notes |
|---|---|---|---|
| macOS Sequoia 15.0.1 (24A348) | 2.14.3 | 20.12.2 | |
| Ubuntu 24.04 Arm64 | 2.14.3 | 20.18.0 | |
| Fedora, Release 41 | 2.14.3 | 22.11.0 | |
| Windows 11 Pro 24H2 (26100.2033) | 2.14.3 | 20.18.0 | Turborepo only supports specific architectures. windows ia32 is not supported. |
We’re aware of issues on non-Ubuntu Linux distributions. While we don’t officially support them, we’d love to know if you get it working!
Package Manager
JTBDOS defaults to using pnpm as a package manager, but you can use npm, yarn or bun instead by passing a flag during the installation step.
Install pnpm
Install pnpm for your operating system.
Stripe CLI
We use the Stripe CLI to forward payments webhooks to your local machine.
Install the Stripe CLI
Install the Stripe CLI for your operating system.
Once installed, you can login to authenticate with your Stripe account.
Mintlify CLI
We use the Mintlify CLI to preview the docs locally.
Install the Mintlify CLI
Install the Mintlify CLI.
Accounts
JTBDOS relies on various SaaS products. You will need to create accounts with the following services then set the API keys in your environment variables:
- Arcjet, for application security.
- BetterStack, for logging and uptime monitoring.
- Clerk, for authentication.
- Google Analytics, for web analytics.
- Posthog, for product analytics.
- Resend, for transactional emails.
- Sentry, for error tracking.
- Stripe, for payments.