423

In Git, how can I add a remote origin server when my host uses a different SSH port?

git remote add origin ssh://user@host/srv/git/example
0

9 Answers 9

708

You can just do this:

git remote add origin ssh://user@host:1234/srv/git/example

1234 is the ssh port being used

14
  • 19
    Thx. Just a complement : in the path part, use absolute path, not a relative path to user home directory...
    – Snicolas
    Commented May 28, 2012 at 19:54
  • @Snicolas : Why shall one not use a relative path?
    – Hannes
    Commented May 30, 2012 at 19:24
  • 17
    @Sincolas It works if you have the repo in the users home directory: /home/someuser/git-repos/example.git --> ssh://someuser@<host>:<port>/~/git-repos/example.git . btw: you get a <name>.git repo by git clone --bare <adress>
    – MartinL
    Commented Oct 4, 2012 at 18:41
  • @Jameo It is an absolute path.
    – igorw
    Commented Dec 12, 2012 at 21:59
  • 64
    Note that it will not work if you remove the protocol. i.e if you try the following, it will not work. git remote add origin user@host:1234/srv/git/example Commented Aug 12, 2013 at 8:06
159

You need to edit your ~/.ssh/config file. Add something like the following:

Host example.com
    Port 1234

A quick google search shows a few different resources that explain it in more detail than me.

10
  • 19
    It did work for me. I like this approach better than sticking it in the git remote. Thanks! No need to specify an absolute path either this way. Commented Jul 21, 2012 at 22:32
  • This works great. Also that way I can have a specific key instead of the default id_rsa. Not only that, my server is picky and more or less you have to have it right quickly enough which fails if you include password. So I use the PasswordAuthentication no as well. Commented Jan 8, 2014 at 1:33
  • 6
    It's better to have it in the remote than hiding it in the config file like this: when you have everything in just one place you can never forget about the different port number and you can simply copy and paste the URL for anyone else to use.
    – MarcH
    Commented Mar 30, 2014 at 15:42
  • 2
    @MarcH It actually depends upon the situation. I like to use random port numbers on on my VPS instances. Having the port inside the config file is one way you can withhold that information from collaborators (That's when you have multiple remotes, the deployment remote host is different from the internal Source Code repo). Commented Jun 25, 2014 at 12:23
  • @RagunathJawahar I don't think using random port numbers is a very common use case.
    – MarcH
    Commented Jun 25, 2014 at 13:08
44

Rather than using the ssh:// protocol prefix, you can continue using the conventional URL form for accessing git over SSH, with one small change. As a reminder, the conventional URL is:

git@host:path/to/repo.git

To specify an alternative port, put brackets around the user@host part, including the port:

[git@host:port]:path/to/repo.git

But if the port change is merely temporary, you can tell git to use a different SSH command instead of changing your repository’s remote URL:

export GIT_SSH_COMMAND='ssh -p port'
git clone git@host:path/to/repo.git # for instance
8
  • 8
    Adding the square brackets around the git@host:port worked beautifully for me. I am using gitlab and on that server it requires a non standard port but I also cannot use the absolute path to the repo (I don't know it). Thank you
    – Thomas Le
    Commented Jun 22, 2019 at 21:26
  • 2
    This seems like the most flexible method to me as it supports relative paths and doesn't rely on ssh configs
    – nixlarfs
    Commented Oct 3, 2019 at 8:08
  • 1
    Ehm, it's GIT_SSH_COMMAND, check this out git-scm.com/docs/git
    – pratclot
    Commented Jan 15, 2021 at 14:37
  • While adding it as a remote using git remote add, I had to wrap the URL in double quotes to have this syntax work. Like so: git remote add gitea "[git@host:port]:path/to/repo.git" Commented Jan 18, 2021 at 5:42
  • 1
    You need to be a little careful about square brackets, as they are a globbing character. For example, if the name h:path/to/repo.git exists then the glob [git@host:port]:path/to/repo.git will match it. It's an unlikely name, so usually the glob won't match and the string will expand with no change. Commented Dec 8, 2023 at 21:16
41

Best answer doesn't work for me. I needed ssh:// from the beggining.

# does not work
git remote set-url origin [email protected]:10000/aaa/bbbb/ccc.git
# work
git remote set-url origin ssh://[email protected]:10000/aaa/bbbb/ccc.git
1
  • Debian 10 working in another ssh port. Testing ssh -T [email protected] got Error connection time out. Then this setup git remote set-url origin [email protected]:22/USER/REPOSITORY.git fix the problem. Thanks Kujiy!
    – coopeu
    Commented Jan 13, 2021 at 8:06
19

For those of you editing the ./.git/config

[remote "external"]                                                                                                                                                                                                                                                            
  url = ssh://[email protected]:11720/aaa/bbb/ccc                                                                                                                                                                                                               
  fetch = +refs/heads/*:refs/remotes/external/* 
1
  • 2
    Perfect. One question though, how do I do this for submodules? It does not seem to work.
    – m4l490n
    Commented Jul 16, 2018 at 17:03
7

for gitlab, example ssh port is 2224, therefore:

git remote add ssh://[email protected]:2224/your_group/your_project.git

6

Had a similar issue trying to connect to my git server

( have a gitea server in a docker container with ssh-port configured to 2022, instead of standard 22, here as an example my-git-server.lan ).

  1. create ssh key-pair (quiet, without password)
$ ssh-keygen -q -N '' -b 4096 -f ~/.ssh/mykeyfile

(this will create two files: public-key mykeyfile.pub and private-key mykeyfile without any extension)

  1. display contents of the public-key and copy/paste it to your profile's SSH keys in your git-server (similar to how you would do it on Github )
$ cat ~/.ssh/mykeyfile.pub
  1. add following lines to ssh-config to specify git-server's hostname, port and key-file
$ nano ~/.ssh/config
Host my-git-server.lan
  HostName my-git-server.lan
  User git
  Port 2022
  IdentityFile ~/.ssh/mykeyfile

(notice that the username is always git, regardless of your actual username on your git-server)

  1. test ssh connection to your git-server using public-key, .. and receive a success message
$ ssh -T [email protected]
Hi there, username! You've successfully authenticated with the key named /Users/username/.ssh/mykeyfile.pub

.. use -v "verbose mode" to analyse any errors:

$ ssh -Tvvv [email protected]

(again, notice that the username is always git)

  1. specify your remote address ssh://[email protected]:2022/alex/myproject.git for your local git repository (again, notice the user git and the port 2022), .. check remote configuration
$ cd your/local/git/repository/folder
$ git remote add my-git-server ssh://[email protected]:2022/alex/myproject.git
$ git remote -v

( here you also see that on my git-server my actual user is alex and repository is myproject )

Done! You can now work with your git-server .. fetch/commit/push etc.

( this is a copy of my post on serverfault.com )


Update: as rightly noted in the comments - you do not necessarily need to specify port 2022 in the remote-url, since it is already configured in ~/.ssh/config file as PORT 2022.

1
  • 1
    Thank you this works great. One little thing, I did not need to add the PORT to the remote URL. Just create the host in ~/.ssh/config and it automatically will use the port specified there
    – sebasira
    Commented May 7, 2022 at 2:55
0

Just have a look at how to set up your ~/.ssh/config file correctly.

You can specify different settings for different hosts easily.

To solve your problem you would set

Host github.com 
Port 22 
Host * 
Port 1234

Have a look at the ssh_config manual page, it explains everything you need to know on the first few pages.

-1

1.git remote add ${shortname} ${url}

2.git remote remove shortname (is remove a remote)

3.git remote -v (is to see your current remote list)

4.git push remote branch

5.git remote rename A B (rename A to B)

6.git remote show shortname (show remote info)

All this works for me.

0

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.