Skip to content

CLI and configuration

alephgrid --help lists every option. The ones you’ll reach for:

FlagEnvDefault
--data-dirALEPHGRID_DATA_DIR./alephgrid-data
--host / --portALEPHGRID_HOST / ALEPHGRID_PORT127.0.0.1 / 7878
--auth local|accountsALEPHGRID_AUTHlocal: no sign-in, loopback only
--public-urlALEPHGRID_PUBLIC_URLhow people reach the server (needed for SSO; https makes cookies Secure)
--oidc-issuer, --oidc-client-idALEPHGRID_OIDC_* (secret: ALEPHGRID_OIDC_CLIENT_SECRET)no single sign-on
--session-hoursALEPHGRID_SESSION_HOURS12
--space-storage, --space-workbooks, --space-jobs, --space-open-workbooksALEPHGRID_SPACE_*no limits (admins can set them per space)
--memory-limitALEPHGRID_MEMORY_LIMITDuckDB default (80% of RAM, spills to disk)
--threadsALEPHGRID_THREADSall cores
--idle-timeoutseconds without activity before a workbook’s compute sleeps
--profile name=MEM:THREADS[:dedicated]extra compute sizes admins can grant to spaces
--disable-sqlALEPHGRID_DISABLE_SQLSQL allowed; when set, every operation that runs user-written SQL is refused
--demo-rows Ngenerate a demo workbook
alephgrid mcp --url URL --token agc_…ALEPHGRID_URL, ALEPHGRID_AGENT_TOKENconnect an MCP client over stdio to a running server

This table mirrors the repository README at the time of writing; when they disagree, --help on your build is authoritative.