Skip to main content
Run a local Solana validator in a container and forward its ports to connected devices and emulators, so apps on the device can reach localhost:8899 as if the validator ran on the device itself.

​
Shared options

These options apply to start, check, forward, status, and stop:

​
localnet start

Start the validator and forward its ports to every connected device:

​
localnet check

Verify the validator is reachable from every device:

​
localnet forward

Forward validator ports to connected devices — useful after plugging in a new device:

​
localnet logs

Print validator logs:

​
localnet status

Show validator and port forward status:

​
localnet stop

Stop the validator and remove its port forwards:
Last modified on September 1, 2026