Skip to content



To change any configuration SSH to the EC2 instance using the public IP address of the instance and the keypair selected at launch time. The default user is ubuntu.

$ ssh -i ~/keypair.pem [email protected]<ip-addres>

Config directories

All config files for JupyterHub are located in the /opt/jupyterhub/config/ directory.

This includes the that can be used to control the behavior of JupyterHub.

Configuration for the Jupyter sessions can be set globally on the /etc/jupyter directory for example for Voila config.


By default JupyterHub will be available at the public IP address of the instance.

To set a specific DNS as the access point put the DNS in the /opt/jupyterhub/config/jupyterhub_dns file. For example:


Then restart JupyterHub

sudo systemctl restart jupyterhub

And can access JupyterHub at


Note that the software included in the AMI uses only HTTP for communication. We strongly recommended adding SSL termination.

This can be achieved using an external load balancer such as AWS ALB or any external service.

This can also be done directly on the JupyterHub configuration. Generate the certs, move them to the instance and add the following lines to /opt/jupyterhub/config/

c.JupyterHub.ssl_key = '/path/to/my.key'
c.JupyterHub.ssl_cert = '/path/to/my.cert'