---
title: "Deploy JupyterLab (w/ Codex agent)"
description: "JupyterLab with an OpenAI Codex agent that edits and runs your notebooks."
category: "AI/ML"
url: https://railway.com/deploy/jupyterlab-w-codex-agent
---

# Deploy JupyterLab (w/ Codex agent)

JupyterLab with an OpenAI Codex agent that edits and runs your notebooks.

**[Deploy JupyterLab (w/ Codex agent) on Railway](https://railway.com/template/jupyterlab-w-codex-agent)**

Machine-readable deploy manifest (JSON, validated by TemplateCI): https://railway.com/deploy/jupyterlab-w-codex-agent/manifest.json

- **Creator:** AvgSoft
- **Category:** AI/ML

## Template content

### JupyterLab https://cdn.jsdelivr.net/gh/mikedepo/railway-template-assets@e27ec7cd95fc0354f185fc09384927a0b7a9abc0/service-icons/jupyter.svg

- **Image:** quay.io/jupyter/scipy-notebook:2026-10-28
- **Start command:** `/bin/sh -c 'echo IyEvYmluL3NoCiMgSnVweXRlckxhYiAody8gQ29kZXggYWdlbnQpOiB0aGUgSnVweXRlckxhYiBzZXJ2aWNlJ3Mgc3RhcnQgc2NyaXB0LgojIFRoZSB0ZW1wbGF0ZSdzIHN0YXJ0IGNvbW1hbmQgd3JpdGVzIHRoaXMgZmlsZSBmcm9tIGJhc2U2NCBhbmQgcnVucyBpdCAobWFrZS1zdGFydC1jb21tYW5kLm1qcykuCiMKIyBBcyByb290OiBwcmVwYXJlIHRoZSB2b2x1bWUgKHRoZSBob21lIGZvbGRlcikgYW5kIHRoZSBwYXNzd29yZCwgdGhlbiBoYW5kIG92ZXIgdG8gdGhlIGltYWdlJ3Mgb3duIHN0YXJ0LnNoLAojIHdoaWNoIGRyb3BzIHRvIGpvdnlhbiBhbmQgcnVucyB0aGlzIHNjcmlwdCBhZ2Fpbi4KIyBBcyBqb3Z5YW46IGluc3RhbGwgdGhlIENvZGV4IGFnZW50IG9udG8gdGhlIHZvbHVtZSBvbmNlLCB0aGVuIHN0YXJ0IEp1cHl0ZXJMYWIuCkg9L2hvbWUvam92eWFuCk5PREU9djI0LjIyLjIKTk9ERV9TSEEyNTY9NDhjYzBlMjFlMDQ4NzkwZTU0YzBjZjU3NDljMjcyNTAwNTMxM2Q2NTI2NTFjNDBiN2EyMWZlYjk2OTdhYWY3NQpBQ1A9Mi4zLjAKSlVQWVRFUl9BST0zLjIuMApleHBvcnQgUEFUSD0kSC8ubG9jYWwvYmluOiRILy5sb2NhbC9zaGFyZS9ub2RlL2JpbjokUEFUSAojIFF1aWV0IGxvZ3M6IG5vIG5wbSB1cGRhdGUgbm90aWNlLCBubyB1cGRhdGUgY2hlY2sgZnJvbSB0aGUgRmFzdE1DUCBzZXJ2ZXIgaW5zaWRlIEp1cHl0ZXIgQUkuCmV4cG9ydCBOUE1fQ09ORklHX1VQREFURV9OT1RJRklFUj1mYWxzZSBGQVNUTUNQX0NIRUNLX0ZPUl9VUERBVEVTPW9mZgojIENvZGV4IHNpZ25zIGluIHdpdGggT1BFTkFJX0FQSV9LRVk6IEp1cHl0ZXIgQUkgbmV2ZXIgcGlja3MgYSBzaWduLWluIG1ldGhvZCBpdHNlbGYsIHNvIHRlbGwgdGhlIGFkYXB0ZXIgdG8gdXNlCiMgdGhlIEFQSSBrZXkgd2hlbmV2ZXIgQ29kZXggbmVlZHMgb25lLCBhbmQgaGlkZSB0aGUgQ2hhdEdQVCBzaWduLWluIChpdCBvcGVucyBhIGJyb3dzZXIgb24gdGhlIHNlcnZlcikuCmV4cG9ydCBERUZBVUxUX0FVVEhfUkVRVUVTVD0neyJtZXRob2RJZCI6ImFwaS1rZXkifScgTk9fQlJPV1NFUj0xCgppZiBbICIkKGlkIC11KSIgPSAwIF07IHRoZW4KICBybSAtcmYgJEgvbG9zdCtmb3VuZAogIGZvciBmIGluIC5iYXNocmMgLnByb2ZpbGU7IGRvIFsgLWUgJEgvJGYgXSB8fCBpbnN0YWxsIC1vIDEwMDAgLWcgMTAwIC1tIDY0NCAvZXRjL3NrZWwvJGYgJEgvJGY7IGRvbmUKICAjIFB5dGhvbiBvbmx5IHB1dHMgfi8ubG9jYWwncyBzaXRlLXBhY2thZ2VzIG9uIHN5cy5wYXRoIGlmIGl0IGV4aXN0cyB3aGVuIHRoZSBrZXJuZWwgc3RhcnRzLgogIGQ9JChIT01FPSRIIHB5dGhvbiAtbSBzaXRlIC0tdXNlci1zaXRlKQogIG1rZGlyIC1wICRkICYmIGNob3duIDEwMDA6MTAwICRILy5sb2NhbCAkSC8ubG9jYWwvbGliICR7ZCUvKn0gJGQKICBweXRob24gLWMgImltcG9ydCBqc29uLG9zLHN5cztmcm9tIGp1cHl0ZXJfc2VydmVyLmF1dGggaW1wb3J0IHBhc3N3ZDtqc29uLmR1bXAoZGljdChQYXNzd29yZElkZW50aXR5UHJvdmlkZXI9ZGljdChoYXNoZWRfcGFzc3dvcmQ9cGFzc3dkKG9zLmVudmlyb24uZ2V0KHN5cy5hcmd2WzFdKSBvciBzeXMuZXhpdChzeXMuYXJndlsyXSkpKSksc3lzLnN0ZG91dCkiIFwKICAgIEpVUFlURVJfUEFTU1dPUkQgIkpVUFlURVJfUEFTU1dPUkQgaXMgZW1wdHk6IHNldCBpdCBpbiB0aGUgSnVweXRlckxhYiBzZXJ2aWNlIHZhcmlhYmxlcy4iID4gL2V0Yy9qdXB5dGVyL2p1cHl0ZXJfc2VydmVyX2NvbmZpZy5qc29uIHx8IGV4aXQgMQogIGV4ZWMgdGluaSAtZyAtLSBzdGFydC5zaCBzaCAiJDAiCmZpCgp3YW50PSJub2RlICROT0RFLCBjb2RleC1hY3AgJEFDUCwganVweXRlci1haSAkSlVQWVRFUl9BSSIKc3RhbXA9JEgvLmxvY2FsL3NoYXJlL2NvZGV4LWFnZW50L2luc3RhbGxlZApmcmVlX21iPSQoZGYgLVBtICRIIHwgYXdrICdOUj09MiB7cHJpbnQgJDR9JykKaWYgWyAiJChjYXQgJHN0YW1wIDI+L2Rldi9udWxsKSIgPSAiJHdhbnQiIF07IHRoZW4KICA6CmVsaWYgWyAiJHtmcmVlX21iOi0wfSIgLWx0IDEwMDAgXTsgdGhlbgogICMgRnJlZSBhbmQgVHJpYWwgdm9sdW1lcyBhcmUgMC41IEdCOiBhIGhhbGYtZmluaXNoZWQgaW5zdGFsbCB3b3VsZCBsZWF2ZSBubyByb29tIGZvciBub3RlYm9va3MuCiAgZWNobyAiW2NvZGV4XSBvbmx5ICR7ZnJlZV9tYn0gTUIgZnJlZSBvbiB0aGUgdm9sdW1lIGFuZCB0aGUgYWdlbnQgbmVlZHMgYWJvdXQgNzAwIE1COyBKdXB5dGVyTGFiIHN0YXJ0cyB3aXRob3V0IHRoZSBDb2RleCBhZ2VudCIKZWxzZQogIGVjaG8gIltjb2RleF0gaW5zdGFsbGluZyAkd2FudCBvbnRvIHRoZSB2b2x1bWUgKGZpcnN0IHN0YXJ0IG9ubHksIGFib3V0IGEgbWludXRlKSIKICBpZiAoCiAgICBzZXQgLWUKICAgIG1rZGlyIC1wICRILy5sb2NhbC9zaGFyZS9jb2RleC1hZ2VudAogICAgaWYgWyAiJCgkSC8ubG9jYWwvc2hhcmUvbm9kZS9iaW4vbm9kZSAtLXZlcnNpb24gMj4vZGV2L251bGwpIiAhPSAiJE5PREUiIF07IHRoZW4KICAgICAgY2QgL3RtcAogICAgICB3Z2V0IC1xIC0tbm8taHN0cyBodHRwczovL25vZGVqcy5vcmcvZGlzdC8kTk9ERS9ub2RlLSROT0RFLWxpbnV4LXg2NC50YXIueHoKICAgICAgZWNobyAiJE5PREVfU0hBMjU2ICBub2RlLSROT0RFLWxpbnV4LXg2NC50YXIueHoiIHwgc2hhMjU2c3VtIC1jIC0tcXVpZXQgLQogICAgICBybSAtcmYgJEgvLmxvY2FsL3NoYXJlL25vZGUgJiYgbWtkaXIgLXAgJEgvLmxvY2FsL3NoYXJlL25vZGUKICAgICAgdGFyIC14SmYgbm9kZS0kTk9ERS1saW51eC14NjQudGFyLnh6IC1DICRILy5sb2NhbC9zaGFyZS9ub2RlIC0tc3RyaXAtY29tcG9uZW50cyAxCiAgICAgIHJtIC1yZiBub2RlLSROT0RFLWxpbnV4LXg2NC50YXIueHogJEgvLmxvY2FsL3NoYXJlL25vZGUvaW5jbHVkZSAgIyBDIGhlYWRlcnMsIDY3IE1CLCBvbmx5IGZvciBidWlsZGluZyBuYXRpdmUgYWRkb25zCiAgICBmaQogICAgIyBUaGUgYWRhcHRlciBicmluZ3MgaXRzIG93biBDb2RleCBDTEkgKEBvcGVuYWkvY29kZXgpLiBucG0ncyBkb3dubG9hZCBjYWNoZSBnb2VzIHRvIC90bXAsIG5vdCB0aGUgdm9sdW1lLgogICAgbnBtIGluc3RhbGwgLS1nbG9iYWwgLS1wcmVmaXggJEgvLmxvY2FsIC0tY2FjaGUgL3RtcC9ucG0tY2FjaGUgLS1uby1mdW5kIC0tbm8tYXVkaXQgLS1sb2dsZXZlbCBlcnJvciBAYWdlbnRjbGllbnRwcm90b2NvbC9jb2RleC1hY3BAJEFDUAogICAgcm0gLXJmIC90bXAvbnBtLWNhY2hlCiAgICBwaXAgaW5zdGFsbCAtLXF1aWV0IC0tbm8td2Fybi1zY3JpcHQtbG9jYXRpb24ganVweXRlci1haT09JEpVUFlURVJfQUkKICAgIGVjaG8gIiR3YW50IiA+ICRzdGFtcAogICk7IHRoZW4KICAgIGVjaG8gIltjb2RleF0gaW5zdGFsbGVkIgogIGVsc2UKICAgIGVjaG8gIltjb2RleF0gaW5zdGFsbCBmYWlsZWQ7IEp1cHl0ZXJMYWIgc3RhcnRzIHdpdGhvdXQgdGhlIENvZGV4IGFnZW50IGFuZCByZXRyaWVzIG9uIHRoZSBuZXh0IHN0YXJ0IgogIGZpCmZpCgpleGVjIHN0YXJ0LW5vdGVib29rLnB5IC0tU2VydmVyQXBwLnRydXN0X3hoZWFkZXJzPVRydWUK | base64 -d > /usr/local/bin/railway-boot.sh && exec sh /usr/local/bin/railway-boot.sh'`
- **Health check:** /api
- **Public domain:** Yes

## Documentation

# Deploy and Host JupyterLab (w/ Codex agent) on Railway

JupyterLab is the notebook editor for Python. This template adds OpenAI Codex through Jupyter AI: it edits your notebooks, runs cells and commands, and reviews each command before it runs.

![JupyterLab with a Codex agent that edits and runs notebooks](https://cdn.jsdelivr.net/gh/mikedepo/railway-template-assets@56db5a52196bf5c32e9b4cca84b5d81015729315/jupyterlab-codex/banner.png)

## About Hosting JupyterLab (w/ Codex agent)

Choose a password and paste your OpenAI API key on the deploy form. The first start installs the agent (about 30 seconds). Sign in, click the chat icon on the left, start a new chat and pick Codex. Everything survives redeploys.

## Common Use Cases

- Exploring data with Codex
- Writing and fixing notebooks
- Explaining results

## Dependencies for JupyterLab (w/ Codex agent) Hosting

- JupyterLab (Jupyter's scipy-notebook image)
- Jupyter AI with the Codex agent
- An OpenAI API key

### Deployment Dependencies

- [Jupyter AI documentation](https://jupyter-ai.readthedocs.io/en/stable/)
- [OpenAI API quickstart](https://platform.openai.com/docs/quickstart)

### Implementation Details

![Architecture: JupyterLab and the Codex agent in one service; notebooks, packages and the agent on the volume](https://cdn.jsdelivr.net/gh/mikedepo/railway-template-assets@a3646687504c911e6c9d1cdf5d67a2cbcc09628d/jupyterlab-codex/architecture.png)

The agent needs about 0.8 GB of volume and 0.7 GB of memory: use Hobby or higher. Usage is billed to your OpenAI account. Back up the volume.

## Why Deploy JupyterLab (w/ Codex agent) on Railway?


Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.

By deploying JupyterLab (w/ Codex agent) on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.


**Updated 2026-10-29:** first release, JupyterLab 4.6.4, Jupyter AI 3.2.0, Codex ACP adapter 2.3.0 (Codex 0.164.0).


## Similar templates

- [Chat Chat](https://railway.com/deploy/-WWW5r) — Chat Chat, your own unified chat and search to AI platform.
- [Weaviate](https://railway.com/deploy/weaviate-1) — Vector database with hybrid search and an API key-protected API
- [Möbius v0.1 Personal AI OS](https://railway.com/deploy/mobius-v01-personal-ai-os) — Self-hosted AI agent that builds and runs apps for you, with memory.

Open this page in a browser: https://railway.com/deploy/jupyterlab-w-codex-agent