Skip to content

Commit 02df4f3

Browse files
justin808claude
andcommitted
Add Ruby 3.2 downgrade solution to TESTING_LOCALLY.md
The easiest way to fix OpenSSL 3.6 SSL errors is to switch to Ruby 3.2, which: - Doesn't have OpenSSL 3.6 compatibility issues - Matches the CI environment (CI uses Ruby 3.2 and 3.4) - Is already installed via mise Added clear instructions for switching to Ruby 3.2 using mise. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
1 parent 7caca75 commit 02df4f3

File tree

1 file changed

+23
-5
lines changed

1 file changed

+23
-5
lines changed

spec/dummy/TESTING_LOCALLY.md

Lines changed: 23 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -44,12 +44,30 @@ bundle exec rake run_rspec:gem
4444

4545
**System tests** - May fail with SSL errors on Ruby 3.4.3 + OpenSSL 3.6
4646

47-
### For Contributors
47+
### Solution: Use Ruby 3.2 (Recommended)
4848

49-
If you need to run system tests locally:
49+
The easiest fix is to switch to Ruby 3.2, which CI also uses:
5050

51-
1. Consider using Ruby 3.2 or Ruby 3.4 with OpenSSL 3.3 (not 3.6)
52-
2. Or rely on CI for system test verification
53-
3. Focus local testing on unit/integration tests that don't require browser automation
51+
```bash
52+
# If using mise/rtx
53+
mise use ruby@3.2
54+
55+
# Then reinstall dependencies
56+
bundle install
57+
58+
# Run system tests
59+
cd spec/dummy
60+
bundle exec rspec spec/system/integration_spec.rb
61+
```
62+
63+
Ruby 3.2 doesn't have the OpenSSL 3.6 compatibility issues and matches the CI environment more closely.
64+
65+
### Alternative Solutions
66+
67+
If you need to run system tests locally but want to stay on Ruby 3.4:
68+
69+
1. **Use Ruby 3.4 with OpenSSL 3.3** - Requires recompiling Ruby with an older OpenSSL
70+
2. **Or rely on CI** for system test verification
71+
3. **Focus local testing** on unit/integration tests that don't require browser automation
5472

5573
This issue is tracked in: https://github.com/openssl/openssl/issues/20385

0 commit comments

Comments
 (0)