Faaaster Remote Development

Connect to your WordPress sites with one click via secure SSH tunnels

Faaaster Remote Development extension brings seamless remote development to your WordPress sites hosted on Faaaster. Connect instantly, edit files directly, and develop with the full power of VS Code, WP CLI and Composer.

Features

🚀 One-Click Connection

• Browse all your WordPress sites in the sidebar
• Click to connect - that's it!

🔐 Secure by Default

• Web authentication
• Credentials stored in system keychain (macOS Keychain, Windows Credential Manager)
• Encrypted tunnels via Cloudflare Access
• Service tokens never persisted

Quick Start

1. Install the extension

   • Search "Faaaster Remote" in Extensions
   • Click Install

2. Login

   • Click the Faaaster icon in Activity Bar
   • Click "Login to Faaaster"
   • Authenticate in your browser

3. Connect

   • Select your site from the list
   • Click the Connect icon
   • VS Code opens in a new window
   • Paste the password that has been automatically copied in your clipboard (not needed if your SSH key has been added)

Requirements

• VS Code 1.80.0 or higher (or Cursor)
• VS Code Remote - SSH extension
• Active Faaaster account
• Internet connection

Usage

Connecting to a Site

1. Open the Faaaster sidebar
2. Find your site in the list
3. If dev mode is enabled (green icon), click "Connect"
4. If dev mode is disabled (gray icon), click "Enable Dev Mode" first

Managing Dev Mode

Enable Dev Mode:

• Click the play icon (▶) next to a site with dev mode disabled
• Wait ~2 minutes for tunnel creation
• Site icon turns green when ready

Disable Dev Mode:

• Click the stop icon (⏹) next to a site with dev mode enabled
• Saves resources when not developing

Logging Out

• Click the logout icon (🚪) in the Faaaster panel title bar
• Or use Command Palette: Faaaster: Logout

Disconnecting

• Use Command Palette (Cmd+Shift+P) → "Faaaster: Disconnect"
• Or simply close the remote VS Code window

Commands

Access via Command Palette (Cmd+Shift+P):

• Faaaster: Login - Authenticate with Faaaster
• Faaaster: Logout - Clear credentials
• Faaaster: Refresh Sites - Reload sites list
• Faaaster: Connect - Connect to selected site
• Faaaster: Enable Dev Mode - Enable dev mode for site
• Faaaster: Disable Dev Mode - Disable dev mode for site
• Faaaster: Disconnect - Stop active tunnel

Passwordless SSH Connection (Optional)

By default, you need to paste the SSH password each time you connect. To enable passwordless connections using your SSH key:

Setup

1. Generate an SSH key (if you don't have one):

   ssh-keygen -t ed25519 -C "your-email@example.com"
   

2. Copy your public key:

   cat ~/.ssh/id_ed25519.pub
   

3. Add it to your WordPress site:

   • Connect to your site using the password method
   • Open the integrated terminal in VS Code
   • Add your public key to the authorized keys file:

   echo "YOUR_PUBLIC_KEY_HERE" >> /app/.ssh/authorized_keys
   

4. Next connections will be passwordless!

Note: You need to do this once per site. The key is stored in /app/.ssh/authorized_keys on the WordPress container.

Troubleshooting

Extension not showing sites

• Ensure you're logged in
• Click refresh icon
• Check internet connection

Connection fails

• Verify dev mode is enabled (green icon)
• Wait a moment if tunnel is waking up
• Check VS Code Remote - SSH is installed

Authentication expired

• Run "Faaaster: Login" command
• Re-authenticate in browser

Tunnel timeout

• Tunnel may be sleeping
• Try connecting again (auto-wake)
• Or manually enable dev mode

License

MIT - See LICENSE file for details