When trying to push to a remote location from a local workstation.
Pushing to a remote
Use git push to push commits made on your local branch to a remote repository.
The git push command takes two arguments:
- A remote name, for example,
origin - A branch name, for example,
master
For example:
git push <REMOTENAME> <BRANCHNAME> As an example, you usually run git push origin master to push your local changes to your online repository.
Renaming branches
To rename a branch, you'd use the same git push command, but you would add one more argument: the name of the new branch. For example:
git push <REMOTENAME> <LOCALBRANCHNAME>:<REMOTEBRANCHNAME> This pushes the LOCALBRANCHNAME to your REMOTENAME, but it is renamed to REMOTEBRANCHNAME.
Dealing with "non-fast-forward" errors
If your local copy of a repository is out of sync with, or "behind," the upstream repository you're pushing to, you'll get a message saying non-fast-forward updates were rejected. This means that you must retrieve, or "fetch," the upstream changes, before you are able to push your local changes.
For more information on this error, see "Dealing with non-fast-forward errors."
Pushing tags
By default, and without additional parameters, git push sends all matching branches that have the same names as remote branches.
To push a single tag, you can issue the same command as pushing a branch:
git push <REMOTENAME> <TAGNAME> To push all your tags, you can type the command:
git push <REMOTENAME> --tagsDeleting a remote branch or tag
The syntax to delete a branch is a bit arcane at first glance:
git push <REMOTENAME> :<BRANCHNAME> Note that there is a space before the colon. The command resembles the same steps you'd take to rename a branch. However, here, you're telling Git to push nothing into BRANCHNAME on REMOTENAME. Because of this, git push deletes the branch on the remote repository.
Related articles