Build Instructions

Collapse

• 1

  Clone the repository

  First, you'd need to clone this repository on the server where you'd like to install it. You can do so by using the following command:

  git clone https://github.com/TheLastBilly/wol_control
  

• 2

  Set up a python virtual environment

  Now that the repository is cloned, the next thing you'd like to do is to install virtualenv using pip. We're using a virtual environment for Wol Control to avoid conflicts with currently installed modules on your machine. You can skip this part if you want, but I don't recommend it.

  python3 -m pip install --user virtualenv
  

  This will install virtualenv for your current user (no need for sudo).

  Next you'll have to create a python virtual environment and install all the necessary python dependencies on it. In order to do so, use the following commands:

  Make sure to move to the repository's directory first.

  python3 -m virtualenv ~/.wol_control_env
  

  This command will create a virtual environment on your home directory (~/) named wol_control_env. The . is used to make this a hidden folder so you wouldn't normally see it unless you actively look for it. Regardless, you can name it however you want.

  source ~/.wol_control_env/bin/activate
  python3 -m pip install -r requirements.txt
  

  The first command will active your virtual environment and the second one will install all of the dependencies listed on the requirements.txt file.

• 3

  Set up Wol Control's databse and code

  Now that all the necessary dependencies have been installed, you can now set-up Wol Control's database, create new users and add devices.

  First things first, initialize a new database using the init_db.py script:

  python3 init_db.py
  

  Create a new user and add some devices using the manage_users.py and manage_devices.py scripts respectively:

  python3 manage_users.py
  python3 manage_devices.py
  

  And finally, go to the wol_control/main.py file and set the remote_user variable to the username that you'll use to shut down remote computers with over SSH (more on that later).

View all 7 instructions