Skip to content

Commit

Permalink
Add ssh-agent no such service troubleshooting docs (#346)
Browse files Browse the repository at this point in the history
* Add ssh-agent no such service troubleshooting docs

fixes #345
fixes pygmystack/pygmy-legacy#60

* Remove whitespace from eol in troubleshooting docs

* Update docs/troubleshooting.md

Make it obvious the content is for Docker Desktop v2
users specifically.

Co-authored-by: Karl Hepworth <karl.hepworth@gmail.com>

Co-authored-by: Karl Hepworth <karl.hepworth@gmail.com>
  • Loading branch information
christopher-hopper and fubarhouse authored Feb 3, 2022
1 parent 795423e commit 211516a
Showing 1 changed file with 27 additions and 3 deletions.
30 changes: 27 additions & 3 deletions docs/troubleshooting.md
Original file line number Diff line number Diff line change
Expand Up @@ -202,6 +202,30 @@ Example `hosts` file contents:

10.0.2.2 my-local-website.com.docker.amazee.io

### I get an error like `no such service: amazeeio-ssh-agent` when using `docker-compose up -d` even after pygmy started fine

Restart pygmy and make sure that pygmy could start the ssh-agent container.

pygmy restart
pygmy status

You could see a message like this:

[*] ssh-agent: Running as docker container amazeeio-ssh-agent, loaded keys:

#### Docker Desktop users

If you have recently updated Docker Desktop you should ensure that your turn off Docker Compose v2 support.

1. Open Docker Desktop Preferences
1. Uncheck the option labelled "Use Docker Compose v2"
1. Click Apply and Restart

Once completed, try starting pygmy and run your `docker-compose up -d` commands again.

pygmy up
docker-compose up -d

## pygmy

Most issues with `pygmy` can be resolved with:
Expand All @@ -224,16 +248,16 @@ If during starting of `pygmy` you see an error like that:
Error starting userland proxy: listen tcp 0.0.0.0:53: bind: address already in use
Error: failed to start containers: amazeeio-dnsmasq

You are probably on Ubuntu and the by default started DNS server by Ubuntu conflicts with the one we provide with `pygmy`. The resolution depends on Ubuntu version.
You are probably on Ubuntu and the by default started DNS server by Ubuntu conflicts with the one we provide with `pygmy`. The resolution depends on Ubuntu version.

#### Ubuntu before 18.04
You should disable it, see here: http://askubuntu.com/a/233223 (no worries, the default started DNS server is actually not used, so it's safe to disable it).

#### Ubuntu 18.04 and later
You should disable it as described https://mmoapi.com/post/how-to-disable-dnsmasq-port-53-listening-on-ubuntu-18-04.
You should disable it as described https://mmoapi.com/post/how-to-disable-dnsmasq-port-53-listening-on-ubuntu-18-04.
Instead of reboot the system, remove */etc/resolv.conf* file (still symlinking to a systemd-resolved file) and create an empty one.

sudo rm /etc/resolv.conf
sudo rm /etc/resolv.conf
sudo touch /etc/resolv.conf

If you still run into the error run following command `sudo netstat -tulpn` to see the processlist look for the service running on port 53 (you should find that process in the `Local Address` column). Look for the Process ID (PID)
Expand Down

0 comments on commit 211516a

Please sign in to comment.