Open Editor →

The Pro Terminal

Gain direct, unrestricted access to the underlying Linux operating system powering your cloud workstation.

Beyond the "Run" Button and REPL

While the standard execution engine, REPL and visual Package Manager cover 90% of development needs, advanced development workflows often requires interacting directly with the shell. The Terminal is an exclusive feature for Pro users that provides a direct, fully interactive Bash connection to your persistent cloud container.

To open the terminal, click the + (New Tab) button in any pane group and select Terminal.

The Execution Architecture

It is important to understand what you are connecting to. When you open the Terminal, our backend executes a secure docker exec -it /bin/bash command against your specific, active project container.

This means the Terminal shares the exact same environment, memory space, and file system as your Python scripts. If a Python script writes a file to disk, you can instantly cat that file in the terminal. If you set an environment variable in the terminal and start a script, the script inherits that variable.

Core Capabilities

The Pro Terminal unlocks standard developer workflows that are impossible through visual UI menus alone:

  • Version Control: git is pre-installed. You can clone repositories, commit changes, push to GitHub, and resolve merge conflicts directly from the command line.
  • Network Utilities: Use curl, wget, and ping to test API endpoints or download datasets directly to your server without passing them through your local machine first.
  • Advanced File Management: Perform complex operations like batch-renaming, deep recursive searches (grep), or compressing specific folders (tar) using native Linux utilities.
  • Process Monitoring: Use commands like top, htop, or ps aux to monitor your workstation's CPU and RAM usage in real-time.

CLI Tool Integration (The Path Bridge)

Many modern Python frameworks rely heavily on Command Line Interfaces (CLIs) to scaffold projects or run migrations. Examples include django-admin, flask db, pytest, and black.

When you install one of these packages via the UI or using pip install --user in the terminal, the executable binary is placed inside your project's hidden .pypackages/bin directory.

Automatic Discovery:
The Python Online execution orchestrator automatically injects this hidden bin folder into your Terminal's $PATH environment variable. This means you do not need to type long, absolute paths to run your tools. If you install Django, you can simply type django-admin startproject myapp . and it will work instantly.

State & Persistence

Because your Pro Workstation is immortal, your Terminal session is highly resilient.

Session Reattachment

If you start a process in the Terminal, you can close the Terminal tab and switch to writing code. The Bash session is held in the memory of our Main Server. When you reopen the Terminal tab, the UI performs a Handshake Sync, instantly reconnecting you to the exact state you left it in.

Note on Updates: While Pro Scripts run completely detached and are immortal, the Terminal relies on an active SSH connection held by the Main Server. If Python Online undergoes a system-wide maintenance reboot, your background Terminal and REPL sessions will be safely reset.

Security Boundaries

To ensure the safety and stability of the entire compute cluster, the Pro Workstation operates within strict security boundaries:

  • Immutable Root: Your container runs with a read-only root file system (excluding your project directory and temporary RAM disks). You cannot run sudo or apt-get install to modify the underlying OS layer.
  • Process Limits: To prevent accidental fork-bombs from crashing the node, your workstation is capped at a maximum of 64 concurrent processes.