Skip to content
ARTEX.sh

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.

  1. 01

    Clone the repo

    This downloads the fork's code and enters its folder.

    git clone https://github.com/RuoJi6/ARTEX.git
    cd ARTEX
  2. 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
  3. 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
  4. 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

  1. 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
  2. 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 SHA256SUMS
    cp config.example.json config.json
    ./start.sh
  3. 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
  4. 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.

  1. 01

    Clone the repo

    This downloads the fork's code and enters its folder.

    git clone https://github.com/BaaRai/ARTEX.git
    cd ARTEX
  2. 02

    Create your .env file

    Open .env and set POSTGRES_PASSWORD, and optionally an LLM key.

    cp .env.example .env
  3. 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
  4. 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/ARTEX

After 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.

  1. 01

    Create the admin account

    Open /setup. RuoJi6 asks for an admin password, BaaRai for the one-time setup token.

  2. 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-...
  3. 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.

  4. 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
  5. 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.

Follow the ARTEX story.

New forks, releases and reports, dated and sourced.

Isometric plane with glowing light columns