Deploy ParrotOS Core — Browser-Based Linux Sandbox
Self-host a Parrot Core Linux shell in your browser, any device
ParrotOS Core Edition (Web Terminal)
Just deployed
/work
Deploy and Host ParrotOS Core Web Terminal on Railway
ParrotOS Core Web Terminal gives you a full Linux shell in your browser, on the lightweight Parrot Core base — a private, always-on cloud sandbox you reach from any device with no SSH client or local setup. Powered by ttyd on the minimal Core edition (the stripped-down Parrot base, not a bundled toolset), it comes with a persistent /data volume that survives redeploys and password-protected access. It's a fast way to get a clean, disposable-yet-persistent Linux environment for learning, quick scripts, and administering your own systems — from a Chromebook, tablet, or locked-down laptop.
What This Template Deploys
| Service | Purpose |
|---|---|
| ParrotOS Core + ttyd | A Parrot Core Linux shell served in the browser over WebSocket |
A single lightweight container — no database, no extra services. Railway provides a public HTTPS domain and a persistent volume at /data. The Core edition keeps the base minimal, so it starts fast and stays small; install the specific tools you need into /data.
About Hosting
This is a simple browser-based Linux sandbox, and the one thing to understand is exactly what persists — this template makes it clear, and keeps usage on legitimate ground.
A real Linux shell, from any browser. Open your Railway domain, authenticate, and you're in a bash shell on a Parrot Core system — run scripts, clone repos, test commands, and learn Linux, all without touching your local machine. Because it's just a browser tab, it works identically from a laptop, Chromebook, tablet, or a work machine where you can't install a terminal.
Core edition means a minimal base — add what you need. Parrot Core is the lightweight foundation edition, deliberately without a bundled application suite, so you start from a clean, small system and install only the tools your work requires — a general-purpose Linux sandbox, not a preloaded appliance.
Only /data persists — plan your work there. This is the key detail: files you keep in the /data volume survive redeploys, restarts, and crashes, but anything outside it — including packages installed with the system package manager — lives on the ephemeral container filesystem and resets on each redeploy. So keep your projects, scripts, and files under /data, and script any custom tool installs so you can re-run them after a redeploy.
Password-protected by default. Access is guarded by HTTP Basic Auth via the USERNAME and PASSWORD variables, so set a strong password — this is a shell on the public internet. Railway's automatic HTTPS encrypts the connection.
Use it responsibly — legitimate use only. This is a general-purpose dev and learning sandbox for writing and testing code, learning Linux, and administering systems you own or are authorized to manage. It is not for scanning, probing, or attacking systems you don't own, or for background resource-abuse like mining — activities that violate Railway's fair-use and acceptable-use policies and can get your account suspended. Keep it to interactive, authorized, legitimate use.
Typical cost: ~$5/month on Railway for light interactive use, scaling with the compute and memory you actually use. ParrotOS and ttyd are free and open source.
How It Compares
| Parrot Core Web Terminal | Cloud IDE SaaS | Local VM | SSH to a VPS | |
|---|---|---|---|---|
| Access | Any browser | Any browser | That machine | SSH client |
| Setup | One click | Account signup | Install + configure | Provision + keys |
| Persistence | /data volume | Vendor | Full | Full |
| Cost model | Flat infra | Subscription/tiers | Free (local) | Per instance |
| Data ownership | Full — your infra | Vendor | Full | Full |
| Best for | Quick sandbox | Full projects | Heavy local work | Server admin |
Cloud IDE services are polished but bill on tiers and hold your environment. A local VM is powerful but tied to one machine and slower to set up. SSHing to a VPS needs a client and key management. This template's edge is instant, zero-setup access from any browser to a private Linux box you control — ideal as a quick, persistent scratch environment on a clean Parrot Core base rather than a heavyweight platform.
Deploy in Under 5 Minutes
- Click Deploy on Railway — the Parrot Core + ttyd container builds (~2 minutes)
- Set a strong
USERNAMEandPASSWORD - Confirm the volume is mounted at
/data - Open your Railway domain and log in with your credentials
- You're in a shell — install the tools you need, work under
/data, and keep your files there
Add a setup script under /data to reinstall your tools after a redeploy.
Common Use Cases
- Cloud scratch environment — a disposable-yet-persistent Linux box for quick scripts and testing
- Code from any device — work from a Chromebook, tablet, or locked-down laptop with no local setup
- Quick repo testing — clone a Git repo and run or test it in seconds, then reset the environment
- Remote admin scratchpad — a browser-reachable shell for quick tasks on systems you manage
Configuration
| Variable | Required | Description |
|---|---|---|
USERNAME | Required | Username for HTTP Basic Auth on the web terminal |
PASSWORD | Required | Password for access — set a strong value; this is a public shell |
| Storage volume | Pre-set | Persistent volume at /data — the only path that survives redeploys |
PORT | Pre-set | The port ttyd serves the terminal on (Railway routes to it) |
Only
/datapersists. Files in/datasurvive redeploys; everything else, including installed packages, resets. Keep projects and files under/data, and script any custom tool installs.
Set a strong password, and use it legitimately. This is a public-internet shell protected by Basic Auth — use a strong
PASSWORD, and keep usage to authorized, legitimate work per Railway's fair-use policy.
Dependencies for ParrotOS Core Web Terminal Hosting
- Railway account — ~$5/month for light interactive use
- A persistent Railway volume at
/datafor your files (included) - A modern web browser — no SSH client, VPN, or local install needed
- Nothing else — it's a single self-contained container
Deployment Dependencies
Implementation Details
The template runs a single ParrotOS Core container with ttyd — a lightweight web terminal built on libwebsockets and xterm.js — serving a bash shell over WebSocket on a Railway-provided HTTPS domain. Parrot Core is the minimal foundation edition of ParrotOS, without a bundled application suite, so the environment starts clean and small and users install only the tools their work requires. Access is secured with HTTP Basic Auth through the USERNAME and PASSWORD variables.
The critical persistence detail is that only the /data volume is durable: files stored there survive redeploys, restarts, and crashes, while everything on the container's root filesystem — including packages installed via the system package manager — is ephemeral and reset on each redeploy. Users should keep projects and important files under /data and script any custom tool installations so they can be re-run after a redeploy.
No database or additional services are required; Railway handles the build, HTTPS termination, public URL, and container lifecycle. The environment is intended for legitimate, authorized use — development, testing, learning, and administering systems you own or are permitted to manage — and not for scanning or attacking third-party systems or for background resource-abuse workloads, which violate Railway's fair-use and acceptable-use policies.
Frequently Asked Questions
What persists across redeploys? Only the /data volume. Files there survive redeploys and restarts; anything outside /data, including installed packages, resets on each redeploy. Keep your work under /data.
Do I need an SSH client? No — you access the full Linux shell through your browser over HTTPS, so it works from any device, including ones where you can't install SSH or a terminal.
What's in the Core edition? Parrot Core is the minimal base — a clean, lightweight Linux foundation without a bundled toolset. You install the specific tools you need for your work, keeping the environment small and uncluttered.
How do I keep tools installed after a redeploy? Because package installs on the root filesystem are ephemeral, put a setup script under /data that reinstalls your tools and run it after a redeploy. Your files in /data are already safe.
Is it secure? Access is password-protected via HTTP Basic Auth over Railway's automatic HTTPS. Set a strong PASSWORD, since this is a shell on the public internet.
What is it meant for? A quick, private cloud sandbox — running scripts, testing repos, learning Linux, and administering your own systems from any browser. Keep usage legitimate and authorized per Railway's fair-use policy.
Why Deploy ParrotOS Core Web Terminal 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 the Parrot Core Web Terminal on Railway you get an instant, private Linux sandbox in your browser — a clean minimal base, a persistent /data volume, password protection, and automatic HTTPS. A zero-setup cloud shell you reach from any device, for legitimate development and learning, on infrastructure you own.
Template Content
ParrotOS Core Edition (Web Terminal)
decoge/parrotos-core-edition-webterminal-railwayPASSWORD
Choose a Password for ttyd web terminal basic authentication.
USERNAME
Choose a Username for ttyd web terminal basic authentication.
