selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

GitHub
WebCodex logo

Self-host WebCodex

v0.4.6

AI agent tool runtime for self-hosted code development

BetaOpen SourceApache-2.0
Updatedlast week
LanguageRust
Setup difficultyModerate
Stars
2 443
Ports
8080 (Server HTTP API and MCP endpoint), 8443 (QUIC Runner listener (default))
Docker
ghcr.io/yyjeqhc/webcodex-server

What is WebCodex?

This self-hosted runtime system enables AI assistants to access code repositories on your local machines. The architecture uses a Server component that authenticates requests and forwards them to Runner processes running on computers where code lives. You get the ability to inspect files, edit code with safeguards, execute tests and compilers locally, manage Git operations, run long-running tasks visibly, and review work through a browser console. Installation comes via npm, native platform packages (.deb for Debian/Ubuntu, NSIS for Windows, macOS installers), or Docker containers. Set it up on one machine or across multiple machines with a central Server coordinating several Runners.

Should you self-host WebCodex?

WebCodex scores 55/100 on selfhost.directory (how scoring works) and ranks #60 of 166 in Developer Tools. It has 2 443 GitHub stars.

It shipped 7 stable releases in the past year. The latest, v0.4.6, came out on 4 October 2026. New versions land roughly every 2 days.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is Apache-2.0-licensed and written mostly in Rust.

Its closest alternative on selfhost.directory is openhands (87/100, 92 079 stars). It scores higher overall, so compare the two before you pick. See WebCodex vs openhands side by side.

WebCodex README

How to configure WebCodex

  • RUST_LOGinfoLogging level

    Logging level

  • WEBCODEX_ADDR0.0.0.0:8080Server listen address

    Server listen address

  • WEBCODEX_DATA/var/lib/webcodexData directory path

    Data directory path

  • WEBCODEX_OAUTH2_ENABLEDEnable OAuth2 authentication

    Enable OAuth2 authentication

    values: true/false

  • WEBCODEX_PUBLIC_URLPublic HTTPS origin for the Server

    Public HTTPS origin for the Server

  • WEBCODEX_TOKENServer bootstrap/admin credential

    Server bootstrap/admin credential

WebCodex releases & version history

More in Developer Tools

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…