summaryrefslogtreecommitdiffstats
path: root/docs/content/doc/installation/with-docker.en-us.md
diff options
context:
space:
mode:
authorDivyam Bhasin <divbest99@gmail.com>2020-10-04 19:52:40 -0400
committerGitHub <noreply@github.com>2020-10-04 19:52:40 -0400
commit48703c3c68ff3d948b406c422bc4f663da783d87 (patch)
tree8ed9975c25e200c12ac91d60bd7ec72d07318abe /docs/content/doc/installation/with-docker.en-us.md
parent01c7204895b78d5e48600316f25955821c1e6c99 (diff)
downloadgitea-48703c3c68ff3d948b406c422bc4f663da783d87.tar.gz
gitea-48703c3c68ff3d948b406c422bc4f663da783d87.zip
updated docs with caveat for authorized_keys (#13030)
* updated docs with caveat for authorized_keys * wrapped authorized_keys in ticks Co-authored-by: techknowlogick <techknowlogick@gitea.io>
Diffstat (limited to 'docs/content/doc/installation/with-docker.en-us.md')
-rw-r--r--docs/content/doc/installation/with-docker.en-us.md21
1 files changed, 20 insertions, 1 deletions
diff --git a/docs/content/doc/installation/with-docker.en-us.md b/docs/content/doc/installation/with-docker.en-us.md
index c65e7bc229..5a6196b0e2 100644
--- a/docs/content/doc/installation/with-docker.en-us.md
+++ b/docs/content/doc/installation/with-docker.en-us.md
@@ -341,7 +341,9 @@ Your `git` user needs to have an SSH key generated:
sudo -u git ssh-keygen -t rsa -b 4096 -C "Gitea Host Key"
```
-Still on the host, symlink the container `.ssh/authorized_keys` file to your git user `.ssh/authorized_keys`.
+Now, proceed with one of the points given below:
+
+- symlink the container `.ssh/authorized_keys` file to your git user `.ssh/authorized_keys`.
This can be done on the host as the `/var/lib/gitea` directory is mounted inside the container under `/data`:
```
@@ -354,6 +356,23 @@ Then echo the `git` user SSH key into the authorized_keys file so the host can t
echo "no-port-forwarding,no-X11-forwarding,no-agent-forwarding,no-pty $(cat /home/git/.ssh/id_rsa.pub)" >> /var/lib/gitea/git/.ssh/authorized_keys
```
+Lastly, Gitea makes `authorized_keys` backups by default. This could be a problem
+as the symbolic link made to `authorized_keys` previously could end up pointing
+to an old backup. To resolve this, please put the following into your Gitea
+config:
+
+```
+[ssh]
+SSH_BACKUP_AUTHORIZED_KEYS=false
+```
+
+- mount your `.ssh` directory directly into the container i.e. add the
+ following to the `volumes` section of your Docker container config:
+
+```
+- /home/git/.ssh/:/data/git/.ssh/
+```
+
Now you should be able to use Git over SSH to your container without disrupting SSH access to the host.
Please note: SSH container passthrough will work only if using opensshd in container, and will not work if