Skip to content

Commit 21965fd

Browse files
eranco74claude
andcommitted
docs: add Fedora/RHEL build instructions for Linux
Add platform-specific build dependencies for Fedora/RHEL alongside the existing Ubuntu/Debian instructions, including a troubleshooting entry for OpenSSL Perl module issues commonly encountered on Fedora. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1 parent 70c16d8 commit 21965fd

1 file changed

Lines changed: 26 additions & 2 deletions

File tree

README.md

Lines changed: 26 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -171,7 +171,7 @@ Before building opcode from source, ensure you have the following installed:
171171

172172
#### System Requirements
173173

174-
- **Operating System**: Windows 10/11, macOS 11+, or Linux (Ubuntu 20.04+)
174+
- **Operating System**: Windows 10/11, macOS 11+, or Linux (Ubuntu 20.04+, Fedora 40+)
175175
- **RAM**: Minimum 4GB (8GB recommended)
176176
- **Storage**: At least 1GB free space
177177

@@ -223,6 +223,24 @@ sudo apt install -y \
223223
libjavascriptcoregtk-4.1-dev
224224
```
225225

226+
**Linux (Fedora/RHEL)**
227+
```bash
228+
# Install system dependencies
229+
sudo dnf install -y \
230+
webkit2gtk4.1-devel \
231+
gtk3-devel \
232+
libappindicator-gtk3-devel \
233+
librsvg2-devel \
234+
patchelf \
235+
gcc gcc-c++ make \
236+
openssl-devel \
237+
libxdo-devel \
238+
libsoup3-devel \
239+
javascriptcoregtk4.1-devel \
240+
perl-IPC-Cmd \
241+
perl-File-Compare
242+
```
243+
226244
**macOS**
227245
```bash
228246
# Install Xcode Command Line Tools
@@ -290,6 +308,11 @@ brew install pkg-config
290308
2. **Linux: "webkit2gtk not found" error**
291309
- Install the webkit2gtk development packages listed above
292310
- On newer Ubuntu versions, you might need `libwebkit2gtk-4.0-dev`
311+
- On Fedora, the package is named `webkit2gtk4.1-devel`
312+
313+
6. **Fedora: OpenSSL build fails with missing Perl modules**
314+
- Install `perl-IPC-Cmd` and `perl-File-Compare` (included in the Fedora dependencies above)
315+
- Alternatively, skip the vendored OpenSSL build by setting `OPENSSL_NO_VENDOR=1 bun run tauri build`
293316

294317
3. **Windows: "MSVC not found" error**
295318
- Install Visual Studio Build Tools with C++ support
@@ -322,7 +345,8 @@ The build process creates several artifacts:
322345

323346
- **Executable**: The main opcode application
324347
- **Installers** (when using `tauri build`):
325-
- `.deb` package (Linux)
348+
- `.deb` package (Debian/Ubuntu)
349+
- `.rpm` package (Fedora/RHEL)
326350
- `.AppImage` (Linux)
327351
- `.dmg` installer (macOS)
328352
- `.msi` installer (Windows)

0 commit comments

Comments
 (0)