SSH Integration

The m87 CLI includes built-in SSH integration, allowing you to use standard SSH clients to connect to your remote devices using the familiar .m87 domain suffix.

Overview

Once enabled, m87’s SSH integration allows you to use native SSH commands to access your devices without needing to use the m87 CLI directly. This works with any SSH client and all SSH-based tools like scp, rsync, and git.

Enable SSH Integration

Enable SSH Host Resolving

Run the following command to enable SSH integration:

m87 ssh enable

This configures your SSH client to route .m87 domain connections through the m87 CLI.

Connect to Your Device

Once enabled, you can connect to any device using SSH:

ssh <device>.m87

Replace <device> with your device identifier (e.g., my-device.m87).

Usage Examples

Basic SSH Connection

ssh production-server.m87

Copy Files with SCP

# Copy from device to local
scp production-server.m87:/var/log/app.log ./

# Copy from local to device
scp ./config.yml production-server.m87:/etc/app/

Sync with Rsync

# Sync local directory to device
rsync -avz ./src/ production-server.m87:/opt/app/src/

# Sync from device to local
rsync -avz production-server.m87:/var/backups/ ./backups/

Execute Remote Commands

# Run a single command
ssh production-server.m87 "systemctl status nginx"

# Run multiple commands
ssh production-server.m87 "cd /opt/app && git pull && systemctl restart app"

Git over SSH

# Clone a repository from a device
git clone production-server.m87:/opt/repos/myproject.git

# Add a device as a git remote
git remote add production ssh://production-server.m87/opt/repos/myproject.git

How It Works

When you enable SSH integration, m87 configures your SSH client to:

Recognize .m87 domain suffixes
Route these connections through the m87 CLI
Establish a secure tunnel to your device through the m87 platform
Forward the SSH session to the device

This allows you to use standard SSH tools while benefiting from m87’s authentication and tunnel management.

Compatibility

The SSH integration works with:

Standard SSH clients (ssh, openssh-client)
SCP and SFTP
Rsync over SSH
Git over SSH
Any tool that uses SSH as a transport layer

Troubleshooting

Connection refused or timeout

Ensure that:

You’re authenticated: run m87 login
The device is online: check with m87 devices list
SSH integration is enabled: run m87 ssh enable again

Device not found

Verify the device name:

m87 devices list

Use the exact device identifier from the list.

Permission denied

Make sure you have access to the device. Check your device permissions with:

m87 devices list

m87 <device> shell - Direct shell access without SSH
m87 cp - Native m87 file copy
m87 sync - Native m87 file sync

Get Started

Core Concepts

CLI Commands

Guides

Advanced

SSH Integration

Overview

Enable SSH Integration

Usage Examples

Basic SSH Connection

Copy Files with SCP

Sync with Rsync

Execute Remote Commands

Git over SSH

How It Works

Compatibility

Troubleshooting

​Overview

​Enable SSH Integration

​Usage Examples

​Basic SSH Connection

​Copy Files with SCP

​Sync with Rsync

​Execute Remote Commands

​Git over SSH

​How It Works

​Compatibility

​Troubleshooting

​Related Commands

Overview

Enable SSH Integration

Usage Examples

Basic SSH Connection

Copy Files with SCP

Sync with Rsync

Execute Remote Commands

Git over SSH

How It Works

Compatibility

Troubleshooting

Related Commands