bluemachine_docs

Developer Stations

Learn how to provision, run, manage, and connect to persistent Developer Stations via SSH.

Developer Stations are fully persistent, non-ephemeral cloud VM instances designed for long-running processes, hosting remote databases, and interactive coding sessions. Unlike ephemeral runs, the station's files, libraries, configuration, and state are preserved indefinitely.

Manage Stations via the CLI
machine station

Executing the 'machine station' command displays a rich interactive selection menu. The following options are available inside this workspace controller:

  • Create a new persistent station: Prompts you with the machine tier selection list. Generates or reuses a persistent station keypair, spins up the VM on Google Cloud Platform, configures key authorized SSH access, and registers the new Station ID.
  • Connect to an active station (SSH): Fetches your active running persistent environments from the database registry. Selecting a station establishes an interactive terminal SSH tunnel and launches a remote bash console instantly.
  • Delete/terminate an active station: Shuts down the selected VM instance, terminates GCP billing resources, and updates the database state.

When connecting, the BlueMachine CLI configures the SSH protocol parameters automatically. It generates a persistent public/private keypair (saved in ~/.config/bluemachine/) and runs a native SSH sub-process to connect you directly to the machine.

Connect manually over SSH from external clients
# Locate your persistent station SSH key and connect
ssh -i ~/.config/bluemachine/station_id_rsa bluemachine@<station-ip>
Connecting from IDEs (VS Code / Cursor)

Because Stations are standard Ubuntu instances, you can configure your SSH Config file (~/.ssh/config) to access them directly from tools like VS Code Remote SSH. Ensure you specify the station_id_rsa key path and the bluemachine user.

Compute charges are billed down to the second while the station is in the running state. If you stop the station, compute billing immediately drops to $0.00.

Station Costs & Pricing

Billing is charged in USD. For exact billing costs, please refer to our landing page pricing section. The pricing rates in dollars (USD) for each machine class are: • Spark Tiers: Starting at $0.00001 / sec (~$0.036/hr) up to $0.00007 / sec (~$0.252/hr) • Flex Tiers: Starting at $0.00008 / sec (~$0.288/hr) up to $0.00044 / sec (~$1.584/hr) • Prime Tiers: Starting at $0.00064 / sec (~$2.304/hr) up to $0.00352 / sec (~$12.672/hr) • Tensor Tiers (GPUs): Starting at $0.00160 / sec (~$5.76/hr) up to $0.01680 / sec (~$60.48/hr)

STATUS // BETADOCS.BLUEMACHINE