{
  "manifest_version": "1.0.0",
  "template": {
    "id": "673c6fcb-5901-4283-9044-646ba0422fbf",
    "slug": "jupyterlab-4-data-science-workstation",
    "name": "JupyterLab 4 Data Science Workstation",
    "description": "Notebooks with a Python data stack, persistent storage and password login.",
    "url": "https://railway.com/deploy/jupyterlab-4-data-science-workstation",
    "upstream": {
      "repo_url": "https://github.com/baranberkay96/jupyterlab-railway"
    }
  },
  "services": [
    {
      "name": "JupyterLab",
      "source": {
        "repo": "https://github.com/baranberkay96/jupyterlab-railway"
      },
      "needs_volume": true,
      "volume_mount_path": "/home/jovyan",
      "http": true
    }
  ],
  "required_inputs": [
    {
      "key": "TZ",
      "service": "JupyterLab",
      "description": "Time zone for notebooks and terminals (e.g. Europe/Istanbul).",
      "secret": false,
      "strategy": "default",
      "default": "UTC"
    },
    {
      "key": "PORT",
      "service": "JupyterLab",
      "description": "Port Jupyter Server listens on. Railway routes the domain and the healthcheck here.",
      "secret": false,
      "strategy": "default",
      "default": "8888"
    },
    {
      "key": "PIP_USER",
      "service": "JupyterLab",
      "description": "pip and %pip install into ~/.local on the volume, so packages survive redeploys. Set 0 to install into the image (lost on redeploy).",
      "secret": false,
      "strategy": "default",
      "default": "1"
    },
    {
      "key": "GRANT_SUDO",
      "service": "JupyterLab",
      "description": "Set yes to give the jovyan user passwordless sudo (apt installs). System changes are lost on redeploy; only /home/jovyan persists.",
      "secret": false,
      "strategy": "default",
      "default": "no"
    },
    {
      "key": "RESTARTABLE",
      "service": "JupyterLab",
      "description": "Restart Jupyter inside the container when it exits (e.g. File > Shut Down or after installing an extension) instead of stopping the service.",
      "secret": false,
      "strategy": "default",
      "default": "yes"
    },
    {
      "key": "JUPYTER_TOKEN",
      "service": "JupyterLab",
      "description": "API token for IDEs and scripts (Authorization: token ...). Also accepted on the login page. Leave empty for a random token printed in the logs.",
      "secret": true,
      "strategy": "generate",
      "generate": "random_base64_32"
    },
    {
      "key": "JUPYTER_PASSWORD",
      "service": "JupyterLab",
      "description": "Login password for the web UI. Generated at deploy; hashed at start and never exposed to notebooks or terminals.",
      "secret": true,
      "strategy": "generate",
      "generate": "strong_password"
    },
    {
      "key": "JUPYTER_KERNEL_CULL_IDLE_TIMEOUT",
      "service": "JupyterLab",
      "description": "Shut down kernels idle for this many seconds (no browser tab attached) to free RAM. 0 keeps kernels running.",
      "secret": false,
      "strategy": "default",
      "default": "0"
    },
    {
      "key": "RAILWAY_DEPLOYMENT_DRAINING_SECONDS",
      "service": "JupyterLab",
      "description": "Grace period on redeploy so Jupyter can save state and shut kernels down cleanly.",
      "secret": false,
      "strategy": "default",
      "default": "30"
    }
  ],
  "deploy": {
    "mcp": {
      "server": "railway",
      "tool": "deploy_template",
      "args": {
        "template_code": "jupyterlab-4-data-science-workstation"
      }
    },
    "cli": "railway deploy --template jupyterlab-4-data-science-workstation",
    "api": {
      "method": "POST",
      "path": "/graphql/v2",
      "body": {
        "query": "mutation templateDeploy($input: TemplateDeployV2Input!) { templateDeployV2(input: $input) { projectId workflowId } }",
        "variables": {
          "input": {
            "templateId": "673c6fcb-5901-4283-9044-646ba0422fbf",
            "serializedConfig": {
              "buckets": {},
              "services": {
                "4699cefb-9157-57a0-afbb-3c1a058fc94a": {
                  "icon": "https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/svg/jupyter.svg",
                  "name": "JupyterLab",
                  "build": {
                    "builder": "DOCKERFILE"
                  },
                  "deploy": {
                    "healthcheckPath": "/api",
                    "restartPolicyType": "ON_FAILURE",
                    "healthcheckTimeout": 300,
                    "restartPolicyMaxRetries": 10
                  },
                  "source": {
                    "repo": "baranberkay96/jupyterlab-railway",
                    "branch": "main",
                    "rootDirectory": "/services/jupyterlab"
                  },
                  "variables": {
                    "TZ": {
                      "isOptional": true,
                      "description": "Time zone for notebooks and terminals (e.g. Europe/Istanbul).",
                      "defaultValue": "UTC"
                    },
                    "PORT": {
                      "isOptional": true,
                      "description": "Port Jupyter Server listens on. Railway routes the domain and the healthcheck here.",
                      "defaultValue": "8888"
                    },
                    "PIP_USER": {
                      "isOptional": true,
                      "description": "pip and %pip install into ~/.local on the volume, so packages survive redeploys. Set 0 to install into the image (lost on redeploy).",
                      "defaultValue": "1"
                    },
                    "GRANT_SUDO": {
                      "isOptional": true,
                      "description": "Set yes to give the jovyan user passwordless sudo (apt installs). System changes are lost on redeploy; only /home/jovyan persists.",
                      "defaultValue": "no"
                    },
                    "RESTARTABLE": {
                      "isOptional": true,
                      "description": "Restart Jupyter inside the container when it exits (e.g. File > Shut Down or after installing an extension) instead of stopping the service.",
                      "defaultValue": "yes"
                    },
                    "JUPYTER_TOKEN": {
                      "isOptional": true,
                      "description": "API token for IDEs and scripts (Authorization: token ...). Also accepted on the login page. Leave empty for a random token printed in the logs.",
                      "defaultValue": "{{JUPYTER_TOKEN}}"
                    },
                    "JUPYTER_PASSWORD": {
                      "isOptional": true,
                      "description": "Login password for the web UI. Generated at deploy; hashed at start and never exposed to notebooks or terminals.",
                      "defaultValue": "{{JUPYTER_PASSWORD}}"
                    },
                    "JUPYTER_KERNEL_CULL_IDLE_TIMEOUT": {
                      "isOptional": true,
                      "description": "Shut down kernels idle for this many seconds (no browser tab attached) to free RAM. 0 keeps kernels running.",
                      "defaultValue": "0"
                    },
                    "RAILWAY_DEPLOYMENT_DRAINING_SECONDS": {
                      "isOptional": true,
                      "description": "Grace period on redeploy so Jupyter can save state and shut kernels down cleanly.",
                      "defaultValue": "30"
                    }
                  },
                  "networking": {
                    "tcpProxies": {},
                    "serviceDomains": {
                      "<hasDomain>:8888": {
                        "port": 8888
                      }
                    }
                  },
                  "volumeMounts": {
                    "00c1e882-043b-52aa-aebf-2690f698b42c": {
                      "mountPath": "/home/jovyan"
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "post_deploy": {
    "healthcheck": {
      "service": "JupyterLab",
      "method": "GET",
      "path": "/api",
      "expect_status": 200
    }
  },
  "resources": {
    "expected_services": 1,
    "needs_volume": true
  },
  "generated_at": "2026-10-11T22:14:38.939Z",
  "generator_version": "0.1.0",
  "status": "validated",
  "validated_at": "2026-10-11T18:56:41.771Z",
  "success_rate_30d": 1,
  "validation": {
    "last_run_id": "run_a898731aac004aba999c",
    "checks": [
      {
        "name": "workflow_completed",
        "passed": true
      },
      {
        "name": "all_services_deployed",
        "passed": true
      },
      {
        "name": "healthcheck",
        "passed": true
      },
      {
        "name": "stays_up",
        "passed": true
      }
    ],
    "typical_ready_seconds": 138,
    "typical_build_seconds": 91,
    "typical_start_seconds": 30,
    "slowest_service": "JupyterLab"
  }
}
