How to install ARTEX:run a maintained fork, because the original is closed.
The original ARTEX has been closed source since 2026-10-08, so there is no official installer to download. These steps install a maintained fork instead. Every command is copied from that fork's own README, linked below, as of 2026-11-16. This site hosts no ARTEX code and installs nothing for you.
What you need:Docker, a database and an LLM key.
Both forks need the same few things. The READMEs list them like this.
- A machine you control, such as a laptop or a lab VM. Not a public server.
- Docker with Compose for the Docker route. The RuoJi6 install.sh script detects or installs Docker for you.
- PostgreSQL. The Docker route starts it for you. The binary and source routes need a database that you enter in config.json.
- An LLM API key: ANTHROPIC_API_KEY or OPENAI_API_KEY, or enter it on the LLM page in the web console. BaaRai also supports a local Ollama server.
- Go and Node.js with npm, only if you build from source. The README builds with npm ci and go build.
- Free ports 8787 for the web console and API, and 8788 for the traffic recording proxy. Those are the defaults of start.sh.
Which fork:RuoJi6 for releases, BaaRai for an English README.
Stars, versions and push dates are from the site's fork data as of 2026-11-16.
RuoJi6/ARTEX
- Stars
- 2,098
- Version
- v0.3.30
- Last push
- 2026-11-14
The main maintained fork. It ships release zips for five platforms and a Docker image built by its own GitHub Actions. The README is in Chinese, and the app has had an English interface since v0.3.28.
BaaRai/ARTEX
- Stars
- 4,638
- Version
- v0.6.0
- Last push
- 2026-11-16
An English translation with its own v0.5 and v0.6 lines and an English README. There is no prebuilt Docker image: the image is built from your checkout. The console listens on 127.0.0.1 and asks for a one-time setup token on first run.
sharenjun/ARTEX-main is maintained too, but its README still points at the deleted original, so we do not copy it. See all maintained forks on the forks page. All ARTEX forks
Install RuoJi6/ARTEX:Docker Compose in four steps.
From the Docker Compose section of the README. Source: the RuoJi6/ARTEX README.
- 01
Clone the repo
This downloads the fork's code and enters its folder.
git clone https://github.com/RuoJi6/ARTEX.git cd ARTEX - 02
Create your .env file
Open .env and set POSTGRES_PASSWORD. The README says to change it on first deployment. You can add ANTHROPIC_API_KEY here, or set the key later in the web console. ARTEX_TAG is latest by default, and the README says you can pin a release tag such as v0.3.17 instead.
cp .env.example .env - 03
Start it
This pulls the ruoji6/artex image and a Postgres container. The README keeps ./skills and ./data as bind mounts so your data survives restarts.
docker compose up -d - 04
Open the console
Go to http://localhost:8787. On the first visit /setup asks you to set the admin password.
Other ways to install it
- 01
One-click script
The script detects or installs Docker, then asks whether to run everything in Docker or build and run locally. For the Docker choice it writes .env and runs docker compose up -d.
git clone https://github.com/RuoJi6/ARTEX.git cd ARTEX ./install.sh - 02
Prebuilt binary
Download the zip for your platform from the Releases page. The latest release, v0.3.30, has zips for Linux amd64 and arm64, macOS amd64 and arm64 and Windows amd64, plus a SHA256SUMS file. Check the download against it, unzip, then edit config.json to fill in your database. Start with start.sh, not ./artex, as the README says.
sha256sum --ignore-missing --check SHA256SUMScp config.example.json config.json ./start.sh - 03
Build from source
Needs Go and Node.js. These are the README's commands, without its comments.
cd web && npm ci && npm run build:static && cd .. mkdir -p server/webui/dist cp -r web/out/. server/webui/dist CGO_ENABLED=0 go build -tags embedui -o artex ./cmd/artex ./start.sh - 04
Update later
The README updates a Docker install like this. Updating restarts the app, so do it when no task is running.
docker compose pull artex docker compose up -d artex
Install BaaRai/ARTEX:English README, built from your own checkout.
From the Quick start of the README. Source: the BaaRai/ARTEX README.
- 01
Clone the repo
This downloads the fork's code and enters its folder.
git clone https://github.com/BaaRai/ARTEX.git cd ARTEX - 02
Create your .env file
Open .env and set POSTGRES_PASSWORD, and optionally an LLM key.
cp .env.example .env - 03
Build and start
This builds the image from your checkout and starts PostgreSQL. The README says there is no prebuilt image to pull.
docker compose up -d --build - 04
Claim the console
Print the one-time setup token, open http://localhost:8787 and enter it at /setup.
docker compose logs artex | grep "Setup token"
The console listens on 127.0.0.1 by default. To reach it from another machine, the README says to set ARTEX_BIND_ADDR=0.0.0.0 in .env, or to keep loopback and use a reverse proxy or an SSH tunnel. We suggest the tunnel.
Each BaaRai release carries SHA256SUMS, an SBOM and a build attestation. The README verifies a download like this.
sha256sum -c SHA256SUMS
gh attestation verify <zip> --repo BaaRai/ARTEXAfter the install:add a model, then create a task.
A short path through the console. The model and task steps follow the READMEs and our how it works page.
- 01
Create the admin account
Open /setup. RuoJi6 asks for an admin password, BaaRai for the one-time setup token.
- 02
Add your model
Enter the key on the LLM configuration page of the console, or export it before you start. The READMEs also list ARTEX_LLM_PROVIDER, ARTEX_LLM_MODEL, ARTEX_LLM_BASE_URL and ARTEX_LLM_PROXY. BaaRai notes that for the Anthropic format the base URL has no /v1, and for OpenAI formats it ends in /v1.
export ANTHROPIC_API_KEY=sk-... - 03
Create a task
A task has a description, targets, an optional template, allow and block rules, and an ordered chain of LLM profiles. Add only targets you own or may test.
- 04
Watch the run and approve
Three work agents run by default, set in System Settings. Every tool call passes intercept rules, then an LLM judge, then a person. The ports can be changed with start.sh flags.
./start.sh -addr :8787 -proxy :8788 - 05
Read the findings
Each finding keeps the captured request and response, and a retester re-checks fixes.
Use it safely:only on systems you own or may test.
ARTEX is an offensive security tool. Point it only at systems you own, or that you are explicitly authorized to test: your own lab, your employer's assets under a written scope, or a bug bounty target inside its published rules. That is the rule in the BaaRai README. Anything else can be a crime where you live.
Read the terms of the fork you pick. The RuoJi6 README is stricter: it limits use to learning, code research and technical checks in a local isolated environment, and says it must not be used to scan any website or online system, even an authorized or owned one. Under those terms, use a lab only.
Keep it off the internet. TechCrunch reported on 2026-11-06 that Censys found more than 800 ARTEX deployments reachable without a password. Bind to localhost, use an SSH tunnel or a VPN and set a strong password.
Use only images and binaries built by the fork's own repository, or build from source. Do not pull other Docker Hub images named artex: tomicdd/artex and congdonglinux/artex carried a backdoor.
Keep reading:source code, forks and how it works.
Follow the ARTEX story.
New forks, releases and reports, dated and sourced.
