Server

thesis server

Manage a local Thesis core server (Core API + Jupyter).

thesis server start

Start the Thesis Server.

thesis server start [options]

  • Arguments

    • None

  • Options

Option Description Default Required?
-d, --detach Run server in background No
-p, --port <port> The port to run the server on 42421 No
--root-dir <path> Root directory for notebooks Current working directory (or ~/Thesis in bundled apps) No
  • Examples

Foreground:

thesis server start

Background (writes logs to a file):

thesis server start --detach

Use a non-default Core API port:

thesis server start --port 50000
  • Notes
    • Uses a fixed Jupyter port (8888) and a configurable Core API port (--port).
    • Uses PID files under ~/.thesis/pids/ for crash recovery (server.json, jupyter.json).
    • In detached mode, logs are appended to ~/.thesis/logs/server.log.

thesis server stop

Stop the Thesis Server.

thesis server stop

  • Arguments

    • None

  • Options

Option Description Default Required?
(none)
  • Examples
thesis server stop
  • Notes
    • Uses the PID file to find the running process and performs a graceful shutdown (SIGTERM then SIGKILL if needed).
    • Removes server and jupyter PID files after stopping.

thesis server status

Check the Thesis Server status.

thesis server status

  • Arguments

    • None

  • Options

Option Description Default Required?
(none)
  • Examples
thesis server status