Link Search Menu Expand Document


Epoptes consists of a server package called epoptes and a client package called epoptes-client.

Server package installation

Execute the following command as root (use sudo -i first on Ubuntu or su - on Debian):

apt-get install --install-recommends epoptes

After the installation you need to add some users to the “epoptes” group (or use another group as mentioned in the Configuration section below). These users will be allowed to launch the GUI and control clients:

gpasswd -a username epoptes

Client package installation

Before installing the epoptes-client package, it’s necessary to tell the clients how to contact the epoptes server PC. There are three different ways to do that:

  1. By default, epoptes-client tries to connect to the epoptes server with the DNS name “server”. So if you have a DNS server (most people don’t run their own DNS server though), put a corresponding entry there.
  2. If you don’t have a DNS server and your epoptes server has a static IP (many people don’t use static IPs though), you can put a line like server to /etc/hosts in all clients, replacing with the server’s static IP.
  3. If your epoptes server doesn’t have a static IP, then it might be possible to use its avahi (multicast DNS) hostname that is automatically provided in most recent distributions. For example, if your server hostname is “myserver”, try this command in one of your clients: ping myserver.local. If this command works, then your multicast DNS is working properly, and you tell your clients where to find the epoptes server by putting SERVER=myserver.local in /etc/default/epoptes-client in all of them.

If needed, this launchpad question provides more details on the aforementioned methods.

After you’ve configured where the clients will find the epoptes server, execute these commands as root in them:

apt-get install --install-recommends epoptes-client
epoptes-client -c    # Fetches the OpenSSL certificate from the server

Note that packages are not allowed to start programs inside a user’s session, so you need to reboot the clients for the epoptes-client installation to take effect.