Skip to content

Troubleshooting Standalone

Why do that

If you encounter any issues on your standalone, make sure to check the following configuration items :

Networking

The standalone platform runs on localhost (127.0.0.1). This said, make sure your local hostname is reachable. This may not be the case on fresh ubuntu installations. You can check that by issuing a ping on your local hostname. Here is an example on a Ubuntu 16.04:

1
2
3
4
5
6
ubuntu@ubuntu-xenial:~$ hostname
ubuntu-xenial
ubuntu@ubuntu-xenial:~$ ping ubuntu-xenial
PING ubuntu-xenial (127.0.0.1) 56(84) bytes of data.
64 bytes from localhost (127.0.0.1): icmp_seq=1 ttl=64 time=0.016 ms
64 bytes from localhost (127.0.0.1): icmp_seq=2 ttl=64 time=0.035 ms

If the ping does not succeed, add a line to your /etc/hosts file.

For MacOS users: check your /etc/hosts file and make sure all the localhost lines are put upfront, like this:

1
2
3
4
5
6
7
8
9
##
# Host Database
#
# localhost is used to configure the loopback interface
# when the system is booting.  Do not change this entry.
##
127.0.0.1   localhost
::1         localhost
<your other hosts>

Get your hostname by typing $ hostname. If you are not able to ping <hostname>.local then also have to add your hostname to the /etc/hosts file.

1
2
3
127.0.0.1   localhost <hostname>.local
::1         localhost
...

This has nothing to do with the PunchPlatform, but makes address resolution on your localhost (normally) fast.

Timezones

The PunchPlatform needs a timezone correctly configured on the system. You could check it, for example on Ubuntu, by typing:

1
cat /etc/timezone

If it returns something like , it's ok you have nothing to do. Else, please use following command:

1
sudo dpkg-reconfigure tzdata (then choose your timezone)

Please adapt this command to your OS.