⚡ SiliconPin Developer Suite

SiliconPin CLI (sp)

Fast, rootless container deployment, instant public HTTPS tunneling, and managed database orchestration directly from your terminal or CI/CD pipelines.

📥 Install sp CLI 📖 Command Reference 🤖 Onboard AI Agent →

1-Line Automated Installation

Install or update sp on Linux, macOS, or Windows with automatic PATH detection.

🐧 🍎

Linux & macOS (Bash/Zsh/Fish)

Auto-detects architecture (x86_64 or ARM64 / Apple Silicon), installs binary to /usr/local/bin, and configures shell auto-completion.

curl -fsSL https://siliconpin.com/install.sh | bash
🪟

Windows (PowerShell)

Downloads sp.exe, sets up execution in %USERPROFILE%\.sp\bin, and appends to User PATH.

irm https://siliconpin.com/install.ps1 | iex
Direct Standalone Pre-compiled Binaries (v1.7.0)

sp is the CLI. sp-tunnel is the tunnel client, kept as a separate binary: sp tunnel downloads it on first use. The installers, sp self-update and sp tunnel check every download against SHA256SUMS and refuse a mismatch (MD5SUMS for manual comparison).

Platform sp sp-tunnel
Linux x86_64 sp
SHA-256 95ef45a4bfb12bf88586f2efe9ebae7f054705b4afc5125ff02109ba6f6d0d7c
MD5 0b74a57a1134b4e0ca0b92eae45ec2ad
sp-tunnel
SHA-256 cc453a3845aed3c3371d1dc41147670185606ab9a1648557d0f3aba79d14f63e
MD5 426440c4bb8c1c2ffbe0e2240e0476fc
Linux ARM64 sp-linux-arm64
SHA-256 5d03fc8582b3377661b53b54fbb571771e44032b86281344b6e69055dd121a1e
MD5 f92c204004273c7912e966827de5d814
sp-tunnel-linux-arm64
SHA-256 e855b38d2cdaf35aa7b38fd0e27c750acbade4ab74e9eacd84b66806f016dece
MD5 40cc785da0d49479e08c323ce3ad475b
macOS Apple Silicon (M1–M4) sp-darwin-arm64
SHA-256 e6cf65a8b48d0822f9194b521d08b56cc8222ff4ac5dee4d464c55ae2b68ce12
MD5 6a7df19d689c2d94c15b07caa5aedb39
sp-tunnel-darwin-arm64
SHA-256 9802c59efb02b63b89986a2871952936236ced6ea1bb3fcc3cfe70066c203946
MD5 286dad74de0ceb19b7fb575c193c8b71
macOS Intel x86_64 sp-darwin-amd64
SHA-256 3fe93819c9c4f7f1d306250e8aa27186016022f5d58c8d24a7772dc78377f914
MD5 87a5a376dd35a7a378aac4da73e0c410
sp-tunnel-darwin-amd64
SHA-256 5bcb5b43e27fa52fcc758c90b49ebd7fa52bc32b1dee0c9987d909f3eaa18980
MD5 504c09e4d97ca7bc5d082f2744f76dd1
Windows x64 sp.exe
SHA-256 df87e4d44ad213f267a66873d9089be74e3356f0d4e4007e5ddc44eec9c0c2ef
MD5 2dbfcce1a06b7e3d78ddb47724d01ff7
sp-tunnel.exe
SHA-256 e3d8d7dedc2417e3cd468e15fd9016762df2584bcb658c436062162e4a86110d
MD5 f40cf9194cf4981b0bdcd60a1bed31a8
Verify a manual download: sha256sum -c --ignore-missing SHA256SUMS (Linux), shasum -a 256 -c --ignore-missing SHA256SUMS (macOS), Get-FileHash sp.exe -Algorithm SHA256 (Windows).

CLI Command Reference

Full syntax and examples for managing cloud workloads, tunnels, sidecars, and automated backups.

🔑 Authentication & Session Management

Login to SiliconPin via interactive browser OAuth or non-interactive token for headless servers.

# Authentication Commands sp auth
# Interactive OAuth browser login
sp login
# Headless / CI/CD non-interactive token login
sp login --token=$SP_TOKEN
# Inspect authenticated user session
sp whoami
# Sign out and purge local tokens
sp logout

🚀 Workload & Pod Deployments

Deploy container images, local directories, static site builds, or Git repositories.

# Pod Deployment Commands sp deploy
# 1. Deploy pre-built container image
sp deploy my-service --image=docker.io/library/nginx:alpine --port=80
# 2. Deploy static website folder (./build/ or ./dist/)
sp deploy ./dist/ --template=static
# 3. Deploy Git repository with automated container build
sp deploy https://github.com/org/my-api.git --port=3000
# 4. Trigger rolling update on active deployment
sp update <deploymentId>

🌐 Instant Public Tunnels

Expose any local service port to a secure, public HTTPS endpoint with zero firewall setup.

# Live Public Preview sp tunnel
# Expose local dev server on port 3000
sp tunnel 3000
✓ Tunnel live: https://tunnel-xyz.siliconpin.net -> localhost:3000
# first run fetches the separate sp-tunnel client (SHA-256 verified)

🗄️ Managed Database Sidecars

Attach high-performance database containers sharing a private network bridge with your pod.

# Database Sidecars sp deployments attach db
# Attach MariaDB container
sp deployments attach db mariadb <deploymentId>
# Attach MongoDB container
sp deployments attach db mongodb <deploymentId>
# Attach Valkey (Redis) caching container
sp deployments attach db valkey <deploymentId>
# List all attached database services and credentials
sp my dbs

📊 Logs, Filesystem & Snapshot Backups

Stream live logs, inspect container filesystems, and create full snapshot backups.

# Monitoring & Management sp manage
# Follow live container logs in real time
sp log <podId> -f
# List directory contents inside pod container
sp fs ls <podId> /var/www/html
# Create complete snapshot backup (DB + volumes + state)
sp backup <deploymentId>
# Update sp (and sp-tunnel) for your OS, SHA-256 verified
sp self-update

CI/CD Integration Recipe

Deploy automatically on git push using GitHub Actions and SiliconPin non-interactive mode.

.github/workflows/deploy.yml YAML
name: Deploy to SiliconPin Pod
on:
push:
branches: [ main ]
jobs:
deploy:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Install SiliconPin CLI
run: curl -fsSL https://siliconpin.com/install.sh | bash
- name: Deploy Workload
env:
SP_TOKEN: ${{ secrets.SP_TOKEN }}
run: |
sp login --token=$SP_TOKEN
sp deploy . --port=3000

Frequently Asked Questions

Common questions about the SiliconPin CLI and container environments.

Do I need Docker installed locally to use `sp`?
No. When deploying workloads to SiliconPin, container orchestration runs on cloud servers using isolated rootless Podman containers. You do not need Docker running locally to deploy images, static directories, or git repositories.
Where does `sp login` store credentials?
Authentication tokens are stored securely in your user directory at ~/.sp/config.json with restricted user-only file permissions (0600).
How does `sp tunnel` compare to deployed pods?
`sp tunnel` creates a secure reverse-proxy tunnel to expose a local development server (e.g., localhost:3000) to the public internet with a temporary HTTPS URL for rapid testing. A deployed Pod, by contrast, hosts your application code on high-availability cloud servers with persistent NVMe storage and optional database sidecars.
Can autonomous AI agents run `sp` commands?
Yes! `sp` has full support for non-interactive execution flags (--token, --template, --json), enabling Claude Code, Cursor, and AGY to deploy and manage pods without manual prompts. See our AI Agent Onboarding Guide for details.

Ready to Deploy Your First Pod?

Deploy directly from your browser with 1-click WebApps or connect your terminal with the `sp` CLI.

Launch Web Deploy Studio → 🤖 Onboard AI Agent