ssh-copy-id

Instalar a chave pública no authorized_keys da conta remota.

Antes de executar

Exige um meio de autenticação existente, geralmente senha, diretório pessoal remoto gravável e shell compatível. A ferramenta não está presente em todas as instalações de macOS ou Windows. Copie somente o arquivo .pub. Adicionar uma chave não desativa login por senha nem configura OTP.

Exemplos

Instalar a chave pública pela porta SSH padrão.

ssh-copy-id -i ~/.ssh/id_ed25519.pub alice@server.example.com

Instalar pela porta 2222 e testar depois com ssh -p 2222.

ssh-copy-id -p 2222 -i ~/.ssh/id_ed25519.pub alice@server.example.com

Opções e exemplos

-i identity_fileComum

Selecione a chave pública para instalar no servidor. Não copie a chave privada.

Exemplo

ssh-copy-id -i ~/.ssh/id_ed25519.pub alice@server.example.com

-p portComum

Conecte-se ao servidor na porta SSH especificada.

Exemplo

ssh-copy-id -p 2222 -i ~/.ssh/id_ed25519.pub alice@server.example.com

-n

Execute uma simulação sem instalar chaves; a disponibilidade varia de acordo com a versão.

Exemplo

ssh-copy-id -n -i ~/.ssh/id_ed25519.pub alice@server.example.com

-f

Forçar a instalação sem verificar se a chave já está presente; podem ocorrer duplicatas.

Exemplo

ssh-copy-id -f -i ~/.ssh/id_ed25519.pub alice@server.example.com

-o option

Passe uma opção de configuração do cliente SSH para a conexão.

Exemplo

ssh-copy-id -o ConnectTimeout=10 -i ~/.ssh/id_ed25519.pub alice@server.example.com

-F configfile

Use um arquivo de configuração de cliente SSH alternativo.

Exemplo

ssh-copy-id -F ~/.ssh/lab_config alice@server.example.com

Referências oficiais

Revisado em 27 de outubro de 2026