{
  "manifest_version": "1.0.0",
  "template": {
    "id": "0e23d5a6-5b5d-4fe0-a258-025f15a9c060",
    "slug": "jupyterlab-w-codex-agent",
    "name": "JupyterLab (w/ Codex agent)",
    "description": "JupyterLab with an OpenAI Codex agent that edits and runs your notebooks.",
    "url": "https://railway.com/deploy/jupyterlab-w-codex-agent",
    "upstream": {
      "image": "quay.io/jupyter/scipy-notebook:2026-10-28"
    }
  },
  "status": "unvalidated",
  "validated_at": null,
  "success_rate_30d": null,
  "services": [
    {
      "name": "JupyterLab",
      "source": {
        "image": "quay.io/jupyter/scipy-notebook:2026-10-28"
      },
      "needs_volume": true,
      "volume_mount_path": "/home/jovyan",
      "http": true
    }
  ],
  "required_inputs": [
    {
      "key": "PORT",
      "service": "JupyterLab",
      "description": "Port JupyterLab listens on; the public domain points here.",
      "secret": false,
      "strategy": "default",
      "default": "8888"
    },
    {
      "key": "PIP_USER",
      "service": "JupyterLab",
      "description": "pip installs into ~/.local on the volume, so packages survive redeploys.",
      "secret": false,
      "strategy": "default",
      "default": "1"
    },
    {
      "key": "CHOWN_HOME",
      "service": "JupyterLab",
      "description": "Gives the home folder (the volume) to the jovyan user at every start.",
      "secret": false,
      "strategy": "default",
      "default": "yes"
    },
    {
      "key": "RESTARTABLE",
      "service": "JupyterLab",
      "description": "Restarts JupyterLab when you use File > Shut Down, instead of stopping the service.",
      "secret": false,
      "strategy": "default",
      "default": "yes"
    },
    {
      "key": "OPENAI_API_KEY",
      "service": "JupyterLab",
      "description": "Your OpenAI API key, from platform.openai.com (API keys). The Codex agent uses it; usage is billed to your OpenAI account.",
      "secret": true,
      "strategy": "generate",
      "generate": "random_base64_32"
    },
    {
      "key": "RAILWAY_RUN_UID",
      "service": "JupyterLab",
      "description": "Starts the container as root so it can take ownership of the volume; JupyterLab itself runs as the jovyan user.",
      "secret": false,
      "strategy": "default",
      "default": "0"
    },
    {
      "key": "JUPYTER_PASSWORD",
      "service": "JupyterLab",
      "description": "Choose the password you will sign in to JupyterLab with. Use 12 or more characters: anyone with your URL and this password can run code on your server.",
      "secret": true,
      "strategy": "generate",
      "generate": "strong_password"
    },
    {
      "key": "PIP_NO_CACHE_DIR",
      "service": "JupyterLab",
      "description": "Keeps pip from caching downloads on the volume.",
      "secret": false,
      "strategy": "default",
      "default": "1"
    },
    {
      "key": "JUPYTER_ENV_VARS_TO_UNSET",
      "service": "JupyterLab",
      "description": "Removes the plain password from the environment before JupyterLab starts, so notebook code cannot read it.",
      "secret": false,
      "strategy": "default",
      "default": "JUPYTER_PASSWORD"
    }
  ],
  "deploy": {
    "mcp": {
      "server": "railway",
      "tool": "deploy_template",
      "args": {
        "template_code": "jupyterlab-w-codex-agent"
      }
    },
    "cli": "railway deploy --template jupyterlab-w-codex-agent",
    "api": {
      "method": "POST",
      "path": "/graphql/v2",
      "body": {
        "query": "mutation templateDeploy($input: TemplateDeployV2Input!) { templateDeployV2(input: $input) { projectId workflowId } }",
        "variables": {
          "input": {
            "templateId": "0e23d5a6-5b5d-4fe0-a258-025f15a9c060",
            "serializedConfig": {
              "buckets": {},
              "services": {
                "c9941bba-b5e2-4498-9145-98ae7d2455a4": {
                  "icon": "https://cdn.jsdelivr.net/gh/mikedepo/railway-template-assets@e27ec7cd95fc0354f185fc09384927a0b7a9abc0/service-icons/jupyter.svg",
                  "name": "JupyterLab",
                  "deploy": {
                    "startCommand": "/bin/sh -c 'echo IyEvYmluL3NoCiMgSnVweXRlckxhYiAody8gQ29kZXggYWdlbnQpOiB0aGUgSnVweXRlckxhYiBzZXJ2aWNlJ3Mgc3RhcnQgc2NyaXB0LgojIFRoZSB0ZW1wbGF0ZSdzIHN0YXJ0IGNvbW1hbmQgd3JpdGVzIHRoaXMgZmlsZSBmcm9tIGJhc2U2NCBhbmQgcnVucyBpdCAobWFrZS1zdGFydC1jb21tYW5kLm1qcykuCiMKIyBBcyByb290OiBwcmVwYXJlIHRoZSB2b2x1bWUgKHRoZSBob21lIGZvbGRlcikgYW5kIHRoZSBwYXNzd29yZCwgdGhlbiBoYW5kIG92ZXIgdG8gdGhlIGltYWdlJ3Mgb3duIHN0YXJ0LnNoLAojIHdoaWNoIGRyb3BzIHRvIGpvdnlhbiBhbmQgcnVucyB0aGlzIHNjcmlwdCBhZ2Fpbi4KIyBBcyBqb3Z5YW46IGluc3RhbGwgdGhlIENvZGV4IGFnZW50IG9udG8gdGhlIHZvbHVtZSBvbmNlLCB0aGVuIHN0YXJ0IEp1cHl0ZXJMYWIuCkg9L2hvbWUvam92eWFuCk5PREU9djI0LjIyLjIKTk9ERV9TSEEyNTY9NDhjYzBlMjFlMDQ4NzkwZTU0YzBjZjU3NDljMjcyNTAwNTMxM2Q2NTI2NTFjNDBiN2EyMWZlYjk2OTdhYWY3NQpBQ1A9Mi4zLjAKSlVQWVRFUl9BST0zLjIuMApleHBvcnQgUEFUSD0kSC8ubG9jYWwvYmluOiRILy5sb2NhbC9zaGFyZS9ub2RlL2JpbjokUEFUSAojIFF1aWV0IGxvZ3M6IG5vIG5wbSB1cGRhdGUgbm90aWNlLCBubyB1cGRhdGUgY2hlY2sgZnJvbSB0aGUgRmFzdE1DUCBzZXJ2ZXIgaW5zaWRlIEp1cHl0ZXIgQUkuCmV4cG9ydCBOUE1fQ09ORklHX1VQREFURV9OT1RJRklFUj1mYWxzZSBGQVNUTUNQX0NIRUNLX0ZPUl9VUERBVEVTPW9mZgojIENvZGV4IHNpZ25zIGluIHdpdGggT1BFTkFJX0FQSV9LRVk6IEp1cHl0ZXIgQUkgbmV2ZXIgcGlja3MgYSBzaWduLWluIG1ldGhvZCBpdHNlbGYsIHNvIHRlbGwgdGhlIGFkYXB0ZXIgdG8gdXNlCiMgdGhlIEFQSSBrZXkgd2hlbmV2ZXIgQ29kZXggbmVlZHMgb25lLCBhbmQgaGlkZSB0aGUgQ2hhdEdQVCBzaWduLWluIChpdCBvcGVucyBhIGJyb3dzZXIgb24gdGhlIHNlcnZlcikuCmV4cG9ydCBERUZBVUxUX0FVVEhfUkVRVUVTVD0neyJtZXRob2RJZCI6ImFwaS1rZXkifScgTk9fQlJPV1NFUj0xCgppZiBbICIkKGlkIC11KSIgPSAwIF07IHRoZW4KICBybSAtcmYgJEgvbG9zdCtmb3VuZAogIGZvciBmIGluIC5iYXNocmMgLnByb2ZpbGU7IGRvIFsgLWUgJEgvJGYgXSB8fCBpbnN0YWxsIC1vIDEwMDAgLWcgMTAwIC1tIDY0NCAvZXRjL3NrZWwvJGYgJEgvJGY7IGRvbmUKICAjIFB5dGhvbiBvbmx5IHB1dHMgfi8ubG9jYWwncyBzaXRlLXBhY2thZ2VzIG9uIHN5cy5wYXRoIGlmIGl0IGV4aXN0cyB3aGVuIHRoZSBrZXJuZWwgc3RhcnRzLgogIGQ9JChIT01FPSRIIHB5dGhvbiAtbSBzaXRlIC0tdXNlci1zaXRlKQogIG1rZGlyIC1wICRkICYmIGNob3duIDEwMDA6MTAwICRILy5sb2NhbCAkSC8ubG9jYWwvbGliICR7ZCUvKn0gJGQKICBweXRob24gLWMgImltcG9ydCBqc29uLG9zLHN5cztmcm9tIGp1cHl0ZXJfc2VydmVyLmF1dGggaW1wb3J0IHBhc3N3ZDtqc29uLmR1bXAoZGljdChQYXNzd29yZElkZW50aXR5UHJvdmlkZXI9ZGljdChoYXNoZWRfcGFzc3dvcmQ9cGFzc3dkKG9zLmVudmlyb24uZ2V0KHN5cy5hcmd2WzFdKSBvciBzeXMuZXhpdChzeXMuYXJndlsyXSkpKSksc3lzLnN0ZG91dCkiIFwKICAgIEpVUFlURVJfUEFTU1dPUkQgIkpVUFlURVJfUEFTU1dPUkQgaXMgZW1wdHk6IHNldCBpdCBpbiB0aGUgSnVweXRlckxhYiBzZXJ2aWNlIHZhcmlhYmxlcy4iID4gL2V0Yy9qdXB5dGVyL2p1cHl0ZXJfc2VydmVyX2NvbmZpZy5qc29uIHx8IGV4aXQgMQogIGV4ZWMgdGluaSAtZyAtLSBzdGFydC5zaCBzaCAiJDAiCmZpCgp3YW50PSJub2RlICROT0RFLCBjb2RleC1hY3AgJEFDUCwganVweXRlci1haSAkSlVQWVRFUl9BSSIKc3RhbXA9JEgvLmxvY2FsL3NoYXJlL2NvZGV4LWFnZW50L2luc3RhbGxlZApmcmVlX21iPSQoZGYgLVBtICRIIHwgYXdrICdOUj09MiB7cHJpbnQgJDR9JykKaWYgWyAiJChjYXQgJHN0YW1wIDI+L2Rldi9udWxsKSIgPSAiJHdhbnQiIF07IHRoZW4KICA6CmVsaWYgWyAiJHtmcmVlX21iOi0wfSIgLWx0IDEwMDAgXTsgdGhlbgogICMgRnJlZSBhbmQgVHJpYWwgdm9sdW1lcyBhcmUgMC41IEdCOiBhIGhhbGYtZmluaXNoZWQgaW5zdGFsbCB3b3VsZCBsZWF2ZSBubyByb29tIGZvciBub3RlYm9va3MuCiAgZWNobyAiW2NvZGV4XSBvbmx5ICR7ZnJlZV9tYn0gTUIgZnJlZSBvbiB0aGUgdm9sdW1lIGFuZCB0aGUgYWdlbnQgbmVlZHMgYWJvdXQgNzAwIE1COyBKdXB5dGVyTGFiIHN0YXJ0cyB3aXRob3V0IHRoZSBDb2RleCBhZ2VudCIKZWxzZQogIGVjaG8gIltjb2RleF0gaW5zdGFsbGluZyAkd2FudCBvbnRvIHRoZSB2b2x1bWUgKGZpcnN0IHN0YXJ0IG9ubHksIGFib3V0IGEgbWludXRlKSIKICBpZiAoCiAgICBzZXQgLWUKICAgIG1rZGlyIC1wICRILy5sb2NhbC9zaGFyZS9jb2RleC1hZ2VudAogICAgaWYgWyAiJCgkSC8ubG9jYWwvc2hhcmUvbm9kZS9iaW4vbm9kZSAtLXZlcnNpb24gMj4vZGV2L251bGwpIiAhPSAiJE5PREUiIF07IHRoZW4KICAgICAgY2QgL3RtcAogICAgICB3Z2V0IC1xIC0tbm8taHN0cyBodHRwczovL25vZGVqcy5vcmcvZGlzdC8kTk9ERS9ub2RlLSROT0RFLWxpbnV4LXg2NC50YXIueHoKICAgICAgZWNobyAiJE5PREVfU0hBMjU2ICBub2RlLSROT0RFLWxpbnV4LXg2NC50YXIueHoiIHwgc2hhMjU2c3VtIC1jIC0tcXVpZXQgLQogICAgICBybSAtcmYgJEgvLmxvY2FsL3NoYXJlL25vZGUgJiYgbWtkaXIgLXAgJEgvLmxvY2FsL3NoYXJlL25vZGUKICAgICAgdGFyIC14SmYgbm9kZS0kTk9ERS1saW51eC14NjQudGFyLnh6IC1DICRILy5sb2NhbC9zaGFyZS9ub2RlIC0tc3RyaXAtY29tcG9uZW50cyAxCiAgICAgIHJtIC1yZiBub2RlLSROT0RFLWxpbnV4LXg2NC50YXIueHogJEgvLmxvY2FsL3NoYXJlL25vZGUvaW5jbHVkZSAgIyBDIGhlYWRlcnMsIDY3IE1CLCBvbmx5IGZvciBidWlsZGluZyBuYXRpdmUgYWRkb25zCiAgICBmaQogICAgIyBUaGUgYWRhcHRlciBicmluZ3MgaXRzIG93biBDb2RleCBDTEkgKEBvcGVuYWkvY29kZXgpLiBucG0ncyBkb3dubG9hZCBjYWNoZSBnb2VzIHRvIC90bXAsIG5vdCB0aGUgdm9sdW1lLgogICAgbnBtIGluc3RhbGwgLS1nbG9iYWwgLS1wcmVmaXggJEgvLmxvY2FsIC0tY2FjaGUgL3RtcC9ucG0tY2FjaGUgLS1uby1mdW5kIC0tbm8tYXVkaXQgLS1sb2dsZXZlbCBlcnJvciBAYWdlbnRjbGllbnRwcm90b2NvbC9jb2RleC1hY3BAJEFDUAogICAgcm0gLXJmIC90bXAvbnBtLWNhY2hlCiAgICBwaXAgaW5zdGFsbCAtLXF1aWV0IC0tbm8td2Fybi1zY3JpcHQtbG9jYXRpb24ganVweXRlci1haT09JEpVUFlURVJfQUkKICAgIGVjaG8gIiR3YW50IiA+ICRzdGFtcAogICk7IHRoZW4KICAgIGVjaG8gIltjb2RleF0gaW5zdGFsbGVkIgogIGVsc2UKICAgIGVjaG8gIltjb2RleF0gaW5zdGFsbCBmYWlsZWQ7IEp1cHl0ZXJMYWIgc3RhcnRzIHdpdGhvdXQgdGhlIENvZGV4IGFnZW50IGFuZCByZXRyaWVzIG9uIHRoZSBuZXh0IHN0YXJ0IgogIGZpCmZpCgpleGVjIHN0YXJ0LW5vdGVib29rLnB5IC0tU2VydmVyQXBwLnRydXN0X3hoZWFkZXJzPVRydWUK | base64 -d > /usr/local/bin/railway-boot.sh && exec sh /usr/local/bin/railway-boot.sh'",
                    "healthcheckPath": "/api",
                    "restartPolicyType": "ON_FAILURE",
                    "restartPolicyMaxRetries": 10
                  },
                  "source": {
                    "image": "quay.io/jupyter/scipy-notebook:2026-10-28"
                  },
                  "variables": {
                    "PORT": {
                      "isOptional": false,
                      "description": "Port JupyterLab listens on; the public domain points here.",
                      "defaultValue": "8888"
                    },
                    "PIP_USER": {
                      "isOptional": false,
                      "description": "pip installs into ~/.local on the volume, so packages survive redeploys.",
                      "defaultValue": "1"
                    },
                    "CHOWN_HOME": {
                      "isOptional": false,
                      "description": "Gives the home folder (the volume) to the jovyan user at every start.",
                      "defaultValue": "yes"
                    },
                    "RESTARTABLE": {
                      "isOptional": false,
                      "description": "Restarts JupyterLab when you use File > Shut Down, instead of stopping the service.",
                      "defaultValue": "yes"
                    },
                    "OPENAI_API_KEY": {
                      "isOptional": false,
                      "description": "Your OpenAI API key, from platform.openai.com (API keys). The Codex agent uses it; usage is billed to your OpenAI account.",
                      "defaultValue": "{{OPENAI_API_KEY}}"
                    },
                    "RAILWAY_RUN_UID": {
                      "isOptional": false,
                      "description": "Starts the container as root so it can take ownership of the volume; JupyterLab itself runs as the jovyan user.",
                      "defaultValue": "0"
                    },
                    "JUPYTER_PASSWORD": {
                      "isOptional": false,
                      "description": "Choose the password you will sign in to JupyterLab with. Use 12 or more characters: anyone with your URL and this password can run code on your server.",
                      "defaultValue": "{{JUPYTER_PASSWORD}}"
                    },
                    "PIP_NO_CACHE_DIR": {
                      "isOptional": false,
                      "description": "Keeps pip from caching downloads on the volume.",
                      "defaultValue": "1"
                    },
                    "JUPYTER_ENV_VARS_TO_UNSET": {
                      "isOptional": false,
                      "description": "Removes the plain password from the environment before JupyterLab starts, so notebook code cannot read it.",
                      "defaultValue": "JUPYTER_PASSWORD"
                    }
                  },
                  "networking": {
                    "serviceDomains": {
                      "<hasDomain>:8888": {
                        "port": 8888
                      }
                    }
                  },
                  "volumeMounts": {
                    "c9941bba-b5e2-4498-9145-98ae7d2455a4": {
                      "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-29T04:15:00.444Z",
  "generator_version": "0.1.0"
}