1 files changed, 65 insertions, 0 deletions
diff --git a/docs/podman-login.1.md b/docs/podman-login.1.md
new file mode 100644
index 000000000..8d8e688c1
--- /dev/null
+++ b/docs/podman-login.1.md
@@ -0,0 +1,65 @@
+% podman(1) podman-login - Simple tool to login to a registry server
+% Urvashi Mohnani
+# podman-login "1" "August 2017" "podman"
+
+## NAME
+podman-login - Login to a container registry
+
+## SYNOPSIS
+**podman login**
+[**--help**|**-h**]
+[**--authfile**]
+[**--user**|**-u**]
+[**--password**|**-p**]
+**REGISTRY**
+
+## DESCRIPTION
+**podman login** logs into a specified registry server with the correct username
+and password. **podman login** reads in the username and password from STDIN.
+The username and password can also be set using the **username** and **password** flags.
+The path of the authentication file can be specified by the user by setting the **authfile**
+flag. The default path used is **${XDG\_RUNTIME_DIR}/containers/auth.json**.
+
+**podman [GLOBAL OPTIONS]**
+
+**podman login [GLOBAL OPTIONS]**
+
+**podman login [OPTIONS] REGISTRY [GLOBAL OPTIONS]**
+
+## OPTIONS
+
+**--password, -p**
+Password for registry
+
+**--username, -u**
+Username for registry
+
+**--authfile**
+Path of the authentication file. Default is ${XDG_\RUNTIME\_DIR}/containers/auth.json
+
+## EXAMPLES
+
+```
+# podman login docker.io
+Username: umohnani
+Password:
+Login Succeeded!
+```
+
+```
+# podman login -u testuser -p testpassword localhost:5000
+Login Succeeded!
+```
+
+```
+# podman login --authfile authdir/myauths.json docker.io
+Username: umohnani
+Password:
+Login Succeeded!
+```
+
+## SEE ALSO
+podman(1), podman-logout(1), crio(8), crio.conf(5)
+
+## HISTORY
+August 2017, Originally compiled by Urvashi Mohnani <umohnani@redhat.com>