Skip to content
anony edited this page Jul 4, 2026 · 3 revisions

FAQ / Troubleshooting

General

Q: What is RAVEN C2 Framework? A C2 (Command and Control) server framework written in Java, designed to handle many shell sessions and support authorized red team engagements, with Web Panel, CLI, and JavaFX GUI interfaces.

Q: What Java version do I need? Java 17 (OpenJDK) or higher.

Q: Is this legal to use? Only against systems you own or are explicitly authorized to test under a signed agreement. See the Home page's Legal & Ethical Notice.

Installation

Q: Do I need to build from source? No — a precompiled JAR is available at output/RAVEN C2-2.0.0.jar and is kept up to date via GitHub Actions. Building manually is only necessary if you've modified the source or need a platform-specific JavaFX build.

Q: I get a JavaFX native library error when launching GUI mode. This usually means the JAR was built without the correct platform classifier. Rebuild with the matching flag for your OS:

mvn clean package -Djavafx.platform=<linux|windows|macos|openbsd> -q

See Installation and Build.

Q: UnsupportedClassVersionError when running the JAR. Your installed JDK is older than 17. Check with java -version and upgrade if needed.

Runtime

Q: How do I change the listening port? Use -p, --port <port> at launch, or set it persistently in server.properties. See Configuration.

Q: How do I enable mutual TLS? First run --init-certs, generate agent certs with -a/-m ... -am, then start the server with -T, --mtls. Full walkthrough in Certificate Management.

Q: Which mode should I use — Web Panel, CLI, or GUI? Web Panel for team/remote access, CLI for headless or scripted environments, JavaFX GUI for local single-operator desktop use. See Interface Modes.

Q: Can I run multiple protocol types (e.g., Meterpreter-compatible sessions) at once? Yes, pass -M, --meterpreter to enable multi-protocol session handling.

Getting Help

If your issue isn't covered here, search or open a new issue on the Issues tracker.

See Also

Clone this wiki locally