User Tools

Site Tools


setup_script_tutorial

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
setup_script_tutorial [2016/06/30 11:23]
lucy
setup_script_tutorial [2019/03/01 12:33] (current)
lucy [Hardware Optimization (Postgress)]
Line 1: Line 1:
 ==== Introduction ==== ==== Introduction ====
  
-The setup script is done in python and runs under a special account created for LUCY (not root). It can always be re-started using the command python /​opt/​phishing/​current/​tools/​setup/​setup.py ​(or in LUCY version that have been downloaded as 2.8 and higher: docker exec -it `docker ps -q` python /​opt/​phishing/​current/​tools/​setup/​setup.py). Starting from Version 2.4, you will be able to logout from that setup script.+The setup script is done in python and runs under a special account created for LUCY (not root). It can always be re-started using the command
 + 
 +<​code>​python /​opt/​phishing/​current/​tools/​setup/​setup.py</​code>​ 
 + 
 +or if LUCY is running ​in a Docker container use this command: 
 + 
 +<​code>​docker exec -it `docker ps -q` python /​opt/​phishing/​current/​tools/​setup/​setup.py</​code>​ 
  
 ==== Automatic Setup ==== ==== Automatic Setup ====
  
-After turning on the virtual machine, you can either let LUCY do all the configuration (select “Y”) or you can manually configure Lucy (select “No”). In case you choose "​Yes"​ LUCY will do the complete setup and won't ask you for further input. Choose "​Yes"​ only if you have DHCP (Dynamic IP Address) enabled. At the end of the automatic setup you will be given a login and password which you will need to authenticate for the web gui. In case you forgot to write down the password, you can still go into the manual setupcreate a new user and new password.\\+After turning on the virtual machine, you can either let LUCY do all the configuration (select “Y”) or you can manually configure Lucy (select “No”). In case if you choose "​Yes"​ LUCY will do the complete setup and won't ask you for further input. Choose "​Yes"​ only if you have DHCP (Dynamic IP Address) enabled. At the end of the automatic setupyou will be given a login and password which you will need to authenticate for the web GUI. In case if you forgot to write down the password, you can still go into the manual setup and create a new user and new password.\\
  
 ==== Manual Setup ==== ==== Manual Setup ====
  
-**STEP 1: "​Network Settings"​** If you selected “No” in the first menu, you will be asked to configure the network settings (IP address). If you have a DHCP server just choose DHCP. Otherwise configure your IP address manually. If you selected DHCP it can take a while until the settings are saved since LUCY will also test the connection. ​ \\+**STEP 1: "​Network Settings"​** If you selected “No” in the first menu, you will be asked to configure the network settings (IP address). If you have a DHCP server just choose DHCP. Otherwiseconfigure your IP address manually. If you selected DHCP it can take a while until the settings are saved since LUCY will also test the connection. ​ \\
 {{ 9.jpg?​direct&​600 }}\\ {{ 9.jpg?​direct&​600 }}\\
 \\ \\
  
-  * //​**Troubleshooting - DHCP fails**: If the DHCP fails to obtain an IP address double check that you have enabled BRIDGED mode - especially if you have installed LUCY within a virtualized environment. Also make sure no Firewall is blocking access to the DHCP server on your HOST computer and no MAC restrictions are defined on your WLAN/LAN.//+  * //​**Troubleshooting - DHCP fails**: If the DHCP fails to obtain an IP address double check that you have enabled BRIDGED mode - especially if you have installed LUCY within a virtualized environment. Alsomake sure that no Firewall is blocking access to the DHCP server on your HOST computer and no MAC restrictions are defined on your WLAN/LAN.//
  
  
-**STEP 2 "​Domain & User Configuration":​** ​ If you are setting up LUCY for the first time, you will automatically switch to the Domain & User Configuration. LUCY needs a name pointing to the server. It can be anything (like « test.phishing.local » or simply « phishing »). The default name is phish.local. If you hit enter, it will keep this name. Otherwise provide the DNS name (e.g. a dyndns ​name) you have already registered for that IP.\\+**STEP 2 "​Domain & User Configuration":​** ​ If you are setting up LUCY for the first time, you will automatically switch to the Domain & User Configuration. LUCY needs a name pointing to the server. It can be anything (like « test.phishing.local » or simply « phishing »). The default name is phish.local. If you hit enter, it will keep this name. Otherwiseprovide the DNS name (e.g. a DynDNS ​name) you have already registered for that IP.\\
 {{ 10.jpg?​direct&​600 }}\\ {{ 10.jpg?​direct&​600 }}\\
  
   * //​**Troubleshooting - Private vs. Public Domain**: If you give LUCY a domain name, which is not registered on the internet, you will only be able to use it on your browser if you create a host file on your PC from where you accessed LUCY.// ​   * //​**Troubleshooting - Private vs. Public Domain**: If you give LUCY a domain name, which is not registered on the internet, you will only be able to use it on your browser if you create a host file on your PC from where you accessed LUCY.// ​
  
-  * //​**Troubleshooting - Access to the Admin Website**: If you want to access the admin interface via an official domain name, which you have registered, make sure that FQDN is also defined in the domain configuration. Otherwise you will receive a LUCY 404 error page when accessing LUCY via the browser using that domain name.//+  * //​**Troubleshooting - Access to the Admin Website**: If you want to access the admin interface via an official domain name, which you have registered, make sure that FQDN is also defined in the domain configuration. Otherwiseyou will receive a LUCY 404 error page when accessing LUCY via the browser using that domain name.//
  
 \\ \\
Line 32: Line 39:
  
 ==== Troubleshooting ​ ==== ==== Troubleshooting ​ ====
-In order to test issues with your connectivity,​ LUCY offers you a few built in tools. First choose Menu Item 3: "​Network Configuration"​. In this Menu, you have Menu Item 3 again (Network Tools) that offers you the possibility to test the basic connectivity to the internet (ping, traceroute, route etc.). ​+In order to test issues with your connectivity,​ LUCY offers you a few built-in tools. First choose Menu Item 3: "​Network Configuration"​. In this Menu, you have Menu Item 3 again (Network Tools) that offers you the possibility to test the basic connectivity to the internet (ping, traceroute, route etc.). ​
  
 {{ 767.png?600 }} {{ 767.png?600 }}
Line 40: Line 47:
 If you see that Network Connectivity is possible, but LUCY is not able to access the internet, it is possible that: If you see that Network Connectivity is possible, but LUCY is not able to access the internet, it is possible that:
  
-  * a) LUCY is behind ​Firewall: Check that the Firewall allows LUCY to connect to the internet.+  * a) LUCY is behind Firewall: Check that the Firewall allows LUCY to connect to the internet.
   * b) You are using a Proxy to access the internet: You need to configured LUCY to use a Web proxy and provide LUCY with the necessary authorization (within the WebGUI). Also see: [[using_an_external_mail_server_or_web_proxy]]   * b) You are using a Proxy to access the internet: You need to configured LUCY to use a Web proxy and provide LUCY with the necessary authorization (within the WebGUI). Also see: [[using_an_external_mail_server_or_web_proxy]]
  
 ==== Hardware Optimization (Postgress) ​ ==== ==== Hardware Optimization (Postgress) ​ ====
-LUCY (after 3.0) allows you to optimize Postgress DB to use the available memory. In order to optimize Postgress please choose the according menu item.+LUCY (after 3.0) allows you to optimize Postgress DB to use the available memory. In order to optimize Postgress please choose the required ​item in the menu.
  
 {{ pg.png?600 }} {{ pg.png?600 }}
setup_script_tutorial.1467278605.txt.gz · Last modified: 2016/06/30 11:23 by lucy