{"id":41669289,"url":"https://github.com/arextest/arex-standalone","last_synced_at":"2026-01-24T17:36:21.186Z","repository":{"id":83548963,"uuid":"582626222","full_name":"arextest/arex-standalone","owner":"arextest","description":"start using arex quickly in local mode","archived":false,"fork":false,"pushed_at":"2023-12-05T07:26:41.000Z","size":754,"stargazers_count":5,"open_issues_count":2,"forks_count":3,"subscribers_count":3,"default_branch":"main","last_synced_at":"2024-03-20T13:00:43.223Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/arextest.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2022-12-27T12:02:45.000Z","updated_at":"2024-02-28T13:06:15.000Z","dependencies_parsed_at":"2023-12-05T07:46:26.705Z","dependency_job_id":null,"html_url":"https://github.com/arextest/arex-standalone","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/arextest/arex-standalone","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arextest%2Farex-standalone","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arextest%2Farex-standalone/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arextest%2Farex-standalone/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arextest%2Farex-standalone/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/arextest","download_url":"https://codeload.github.com/arextest/arex-standalone/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arextest%2Farex-standalone/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28732748,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-24T10:24:43.181Z","status":"ssl_error","status_checked_at":"2026-01-24T10:24:36.112Z","response_time":89,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-01-24T17:36:21.054Z","updated_at":"2026-01-24T17:36:21.171Z","avatar_url":"https://github.com/arextest.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# \u003cimg src=\"https://avatars.githubusercontent.com/u/103105168?s=200\u0026v=4\" alt=\"Arex Icon\" width=\"27\" height=\"\"\u003e AREX's Standalone Mode\n\n## Introduction\n\nStart using arex quickly in local mode, no need to build storage service or other service separately. \n\nThe project mainly includes two modules:\n\n- **arex-cli**\n\n  command line control interface, through which the local application with \n  [arex-agent-java](https://github.com/arextest/arex-agent-java) attached can be replayed\n\n- **arex-local**\n\n  uses [H2](https://www.h2database.com) as a local storage to save the record data and replay data\n\n\n## Getting Started\n\n***1. download arex-standalone-all.zip***\n\nDownload the `arex-standalone-all.zip` file from the **Assets** directory on the \n[releases](https://github.com/arextest/arex-standalone/releases/latest) page and decompress \n**or** you can access [Gitee](https://gitee.com/arextest/arex-standalone/releases) images \nand synchronize periodically.\n\u003e Alternatively, download the source code locally and compile (`mvn clean install -DskipTests`), \n\u003e replacing the corresponding jar package in the arex-standalone-all folder,\n\u003e The prerequisite is first to compile the agent project:[arex-agent-java](https://github.com/arextest/arex-agent-java) locally, \n\u003e execute command: `mvn clean install -DskipTests` (deploy it to your local Maven repository, as the standalone project will depend on it)\n\n***2. execute script***\n\n- windows\n\n  double click to run **arex-cli.bat** files in the arex-standalone-all folder\n\n- mac/linux\n\n  switch to the arex-standalone-all folder and execute `./arex-cli.sh` or `sh ./arex-cli.sh`\n\nYou can also directly open the command line/terminal to execute the following commands (arex-standalone-all folder):\n\n```other\njava -jar arex-cli.jar\n```\n\n**Note**  \nIf your local project is started in the IDE, simply execute the script.  \nHowever, if the project is started through the cmd: `java -jar`, you need to add the `-javaagent` option before restarting.  \nThe complete command is as follows:\n```other\njava -javaagent:/path/to/arex-agent-\u003cversion\u003e.jar \n-Darex.service.name=your-service-name \n-Darex.storage.mode=local (constant value)\n-Darex.enable.debug=true (constant value)\n-jar your-application.jar\n```\n\n***3. choose pid***\n\nAfter the script starts, enter the welcome screen:\n\n![dashboard](arex-cli/src/main/resources/static/img/welcome.png)\n\n\u003e select the project you need to record based on the Java processes listed in the command line, \n\u003e input [num] and press Enter to continue.\n\nfor example input `3` (based on the project running locally)\n\nafter successfully starting the AREX, the commands currently supported will be listed:\n\n![dashboard](arex-cli/src/main/resources/static/img/home.png)\n\n\u003e If you use IntelliJ IDEA or Eclipse, the log of AREX startup will be output on the console:\n`ArexJavaAgent installed.`\n\nThe supported commands are as follows:\n\n- **ls**- list recorded data (ensure that there are traffic requests coming in locally, for example, \nyou can use Postman to first request the interface of the local project, so that Arex can record it)\n\n  `[option: -o/--operation]` operation name, if multiple interfaces are recorded, \n   the interface can be specified to view the recording case and results will be displayed in the browser\n   (if this option is added, subsequent operations will be based on the current interface)\n\n- **replay**- replay recorded data and view differences\n\n  `[option: -n/--num]` replay numbers, default the latest 10\n\n- **watch**- view replay result and differences\n\n- **debug**- local debugging of specific cases\n\n  `[option: -r/--recordId]` record id, required Option\n\n## Command Demonstration\n\n### ls\n\n![dashboard](arex-cli/src/main/resources/static/img/list.png)\n\nthe above image shows a total of 4 interfaces for your local project recorded \nand the number of times each interface was recorded\n\n\u003e ensure that there are requests coming in locally and recorded,\nthe console will output the logs of `[arex] save mover:`\n\n### ls -o/--operation\n\nfor example: `ls -o 3` view the recording data of the 3rd interface: /biz/getOrderInfo\n\n\u003eresults will be displayed in the browser and the command prompt is updated to the current operation name\n\n![dashboard](arex-cli/src/main/resources/static/img/list-o.png)\n\nthe page will list all recording data and types under this interface:\n\n![dashboard](arex-cli/src/main/resources/static/img/ls-browser-list.png)\n\nclick on the symbol `+` or `Detail` button to view the specific recording information:\n\n![dashboard](arex-cli/src/main/resources/static/img/ls-browser-detail.png)\n\n### replay\n\n![dashboard](arex-cli/src/main/resources/static/img/replay.png)\n\nexpand to see the difference details\n\n![dashboard](arex-cli/src/main/resources/static/img/replay-browser.png)\n\n**the principle of replay is to request the API of your local project using recorded data**\n\n\u003e if the port of your local project is not 8080, you can add the `-p` option to specify the port, \nsuch as: `replay -p 8081`\n\nSimilarly, you can also click the `Debug` button to play back a single case.\n\n## Local Storage\n\nThe locally recorded data is stored in the current user of the operating system:\n`~/arexdb.mv.db`, you can view and edit data by accessing 'http://localhost:8080/h2-console' in a browser.\n\n![dashboard](arex-local/src/main/resources/static/img/h2-console.png)\n\nJDBC URL: `jdbc:h2:tcp://localhost/~/arexdb`\nUser Name: `arex`\nPassword: `123`\n    \n### tips\n1. 'http://localhost:8080/h2-console' port 8080 is your local application port, based on the port number of your application.\n2. if your application is Spring Boot Web project need to add following config:  \n   `spring.h2.console.enabled=true`  \n   `spring.h2.console.path=/h2-console`  \nand add h2 dependency to pom.xml:  \n```xml\n\u003cdependency\u003e\n    \u003cgroupId\u003ecom.h2database\u003c/groupId\u003e\n    \u003cartifactId\u003eh2\u003c/artifactId\u003e\n    \u003cversion\u003e2.1.210\u003c/version\u003e\n    \u003cscope\u003eruntime\u003c/scope\u003e\n\u003c/dependency\u003e\n```\nif is JEE project need is to expose it using the WEB-INF/web.xml deployment descriptor:\n```xml\n\u003cservlet\u003e\n  \u003cservlet-name\u003eh2-console\u003c/servlet-name\u003e\n  \u003cservlet-class\u003eorg.h2.server.web.WebServlet\u003c/servlet-class\u003e\n\u003c/servlet\u003e\n\u003cservlet-mapping\u003e\n  \u003cservlet-name\u003eh2-console\u003c/servlet-name\u003e\n  \u003curl-pattern\u003e/h2-console/*\u003c/url-pattern\u003e\n\u003c/servlet-mapping\u003e\n```\n\n## Note\n\n\u003e For issues that are not on this list, please search for them in the \n\u003e [issue](https://github.com/arextest/arex-standalone/issues)\n\n1. IntelliJ IDEA in debug mode will affect arex-agent-java (**below 2021 version**), \n   so you can remove the check mark from:\n   File -\u003e Settings -\u003e Build, Execution, Deployment -\u003e Debugger -\u003e Async Stack Traces -\u003e instrumenting agent, \n   or upgrade the idea version. specific reasons refer to\n   [https://github.com/JetBrains/intellij-community/pull/1528](https://github.com/JetBrains/intellij-community/pull/1528)\n2. If your JDK version is 1.8, ensure that **tools.jar** exists in your computer's `/jdk/lib/`, \n   agent startup needs to rely on this jar.\n\n## License\n- Code: [Apache-2.0](https://github.com/arextest/arex-agent-java/blob/main/LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Farextest%2Farex-standalone","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Farextest%2Farex-standalone","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Farextest%2Farex-standalone/lists"}