Interactive notebook server with Marimo - a reactive Python notebook.

• Python 3 & pip - If not already installed
• OpenSSL - For SSL certificate generation
• Nginx - Reverse proxy for HTTPS/SSL termination
• Marimo - Reactive Python notebooks
• Brev GPU notebooks - GPU validation, multi-GPU training, etc. (always included)
• Marimo examples - Sample notebooks from marimo-team/examples (customizable)
• PyTorch with CUDA - GPU-accelerated machine learning
• Data science packages - pandas, numpy, scikit-learn, plotly, etc.
• SSL/TLS certificates - Self-signed certificates for HTTPS access

• Runs as systemd service - Auto-starts with the system
• Secure by default - Bound to localhost with token authentication
• Example notebooks included - Ready to explore
• Battle-tested user detection - Works with ubuntu, nvidia, shadeform users

• HTTPS/SSL encryption - All traffic encrypted via nginx reverse proxy
• Localhost binding - Service is bound to 127.0.0.1 only (not exposed to network)
• Token authentication - Cryptographically secure token required for access
• Secure token storage - Token stored in ~/.config/marimo/token with restricted permissions (600)
• Self-signed certificates - Automatically generated SSL certificates (valid for 1 year)

bash setup.sh

Takes ~2-3 minutes.

Use your own notebook repository (merges with Brev notebooks):

MARIMO_REPO_URL="https://github.com/your-org/your-notebooks.git" bash setup.sh

Skip cloning marimo-team examples (still includes Brev notebooks):

MARIMO_REPO_URL="" bash setup.sh

Custom notebooks directory:

MARIMO_NOTEBOOKS_DIR="my-notebooks" bash setup.sh

Note: Brev GPU notebooks from brevdev/marimo are always included and merged into your notebooks directory.

# Service management
sudo systemctl status nginx
sudo systemctl restart nginx

# View logs
sudo journalctl -u marimo -f
sudo tail -f /var/log/nginx/error.log

# View authentication token
cat ~/.config/marimo/token

The service is bound to localhost (127.0.0.1) for security. Access it via HTTPS:

# Open in browser on the server
https://localhost:8443

You'll be prompted for the authentication token. Retrieve it with:

cat ~/.config/marimo/token

For secure remote access, use SSH port forwarding:

# From your local machine
ssh -L 8443:localhost:8443 user@your-server

# Then access in your local browser
https://localhost:8443

The token is still required for authentication.

From brevdev/marimo:

• gpu_validation.py - GPU testing, metrics, stress testing
• multi_gpu_training.py - Multi-GPU training examples
• llm_finetuning_dashboard.py - LLM fine-tuning with monitoring
• graph_analytics_cugraph.py - GPU-accelerated graph analytics
• nerf_training_viewer.py - NeRF training visualization

From marimo-team/examples:

• Data visualization examples
• Interactive widgets
• Machine learning demos
• And more!

Change the port: Edit /etc/systemd/system/marimo.service and change MARIMO_PORT environment variable, then:

sudo systemctl daemon-reload
sudo systemctl restart marimo
sudo systemctl restart nginx


**Add more notebooks:**
```bash
cd ~/marimo-examples  # Or your custom directory
git pull  # Update examples
# Or add your own .py files

Service won't start:

sudo journalctl -u marimo -n 50  # View recent logs
sudo systemctl status marimo      # Check status

Can't access web UI:

• Check service is running: sudo systemctl status marimo
• Check Nginx service: sudo systemctl status nginx
• Check firewall: sudo ufw status
• Access locally: https://localhost:8443
• For remote access, use SSH port forwarding (see above)

Authentication token not working:

• Verify token file exists: ls -la ~/.config/marimo/token
• Check token permissions: chmod 600 ~/.config/marimo/token
• View token: cat ~/.config/marimo/token
• Restart service: sudo systemctl restart marimo

Marimo not found:

pipx list                     # Check if installed
pipx install marimo           # Reinstall if needed