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
grok-reg-tool logo

Self-host grok-reg-tool

v0.1.2

Self-hosted Grok registration web console with automation

BetaOpen SourceMIT
Updated4 months ago
LanguageTypescript
Setup difficultyModerate
Stars
217
Port
6657 (Web UI)
Install with Docker Compose

What is grok-reg-tool?

grok-reg-tool is a self-hosted web console that automates the registration of Grok (xAI) accounts. It provides a web UI to start, stop, and monitor registration tasks with real-time logs. The tool uses DrissionPage for browser automation and integrates with cloudflare_temp_email for reading email verification codes. Registered accounts are stored locally with SSO token output. It runs via Docker Compose with persistent data storage, and includes a Node.js web server with a Python registration backend. The project is licensed under MIT and intended for research, learning, or self-hosted experimentation only.

Should you self-host grok-reg-tool?

grok-reg-tool scores 38/100 on selfhost.directory (how scoring works) and ranks #24 of 26 in Automation. It has 217 GitHub stars.

It shipped 3 stable releases in the past year. The latest, v0.1.2, came out on 8 June 2026.

Setup is moderate: expect some configuration beyond a single command. It is MIT-licensed and written mostly in Typescript.

Its closest alternative on selfhost.directory is Node RED (81/100, 23 790 stars). It scores higher overall, so compare the two before you pick. See grok-reg-tool vs Node RED side by side.

Features

  • DrissionPage Automation
  • Email Verification
  • Forced Password Change
  • Local Account Pool
  • SSO Token Output
  • Web Console

grok-reg-tool README

How to install grok-reg-tool

Install grok-reg-tool with Docker Compose

Docker and Docker Compose installed
Environment variables
WEB_PORT, RUN_COUNT, MAIL_API_BASE, MAIL_ADMIN_AUTH, MAIL_DOMAIN, HTTP_PROXY, BROWSER_PROXY, COOKIE_SECURE

git clone https://github.com/FengZi1221/grok-reg-tool.git cd grok-reg-tool/docker cp .env.example .env

Edit docker/.env with your configuration

docker compose up -d --build

Data persisted in docker/data/

How to configure grok-reg-tool

  • BIND_HOST0.0.0.0Web server bind address

    Web server bind address

  • BROWSER_PATH/usr/bin/chromiumBrowser executable path (chromium in Docker)

    Browser executable path (chromium in Docker)

  • BROWSER_PROXYOptional proxy for browser automation

    Optional proxy for browser automation

  • COOKIE_SECURESet to 1 when using HTTPS reverse proxy; leave empty for direct HTTP

    Set to 1 when using HTTPS reverse proxy; leave empty for direct HTTP

    values: 1 or empty

  • DATA_DIR/dataWebUI config and account data directory

    WebUI config and account data directory

  • HTTP_PROXYOptional HTTP proxy for requests

    Optional HTTP proxy for requests

  • MAIL_ADMIN_AUTHcloudflare_temp_email admin password for x-admin-auth

    cloudflare_temp_email admin password for x-admin-auth

  • MAIL_API_BASEcloudflare_temp_email backend Worker/API root URL

    cloudflare_temp_email backend Worker/API root URL

  • MAIL_DOMAINDomain configured in cloudflare_temp_email for receiving emails

    Domain configured in cloudflare_temp_email for receiving emails

  • PORT6657Web server listen port inside container

    Web server listen port inside container

  • PYTHON_PATH/usr/local/bin/python3Python interpreter path

    Python interpreter path

  • REGISTER_DIR/app/registerRegistration scripts directory

    Registration scripts directory

  • RUN_COUNT10Number of registration rounds

    Number of registration rounds

  • SSO_DIR/data/ssoSSO token output directory

    SSO token output directory

  • WEB_PORT6657Web UI exposed port (mapped to host in Docker)

    Web UI exposed port (mapped to host in Docker)

grok-reg-tool releases & version history

More in Automation

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…