Difference between revisions of "Prey"

From ArchWiki
Jump to: navigation, search
(Configuration)
 
(21 intermediate revisions by 11 users not shown)
Line 1: Line 1:
 
[[Category:Networking]]
 
[[Category:Networking]]
 
[[Category:Security]]
 
[[Category:Security]]
[http://www.preyproject.com/ Prey] is a set of bash scripts that helps you track your computer when it is stolen.
+
[[ja:Prey]]
 +
[http://preyproject.com/ Prey] is a set of scripts that helps you track your computer when it is stolen.
  
 
This guide shows you how to install Prey.
 
This guide shows you how to install Prey.
Line 7: Line 8:
 
== Installation ==
 
== Installation ==
  
Install {{AUR|prey-tracker}} from the [[AUR]].  
+
Install {{AUR|prey-node-client}} from the [[AUR]].  
  
 
== Configuration ==
 
== Configuration ==
Edit {{ic|/usr/share/prey/config}} and add your device key and API key in the appropriate place. Run {{ic|/usr/share/prey/prey.sh}} as root to ensure that the configuration is correct.
+
{{Note|It is [http://answers.preyproject.com/topics/add-new-device-manually#message-53178b9f27af477ee7000492 no longer possible] to add new devices using the control panel on Prey's website. Use [https://github.com/prey/prey-node-client the Node.js client] or [[#GUI config|the GUI]].}}
  
{{Note|The old version of {{AUR|prey-tracker}}  ( < 0.5.9-3) was in {{ic|/usr/share/prey-tracker/}} folder, now (>0.5.10-2) it is in {{ic|/usr/share/prey/}}.}}
+
First you must to have a Prey's account, if you don't have it, you can create it on the [https://panel.preyproject.com/signup/ website].
 +
To add your device, run {{ic|prey_project config account setup}} and type your email account and password. Or use the [[#GUI config|the GUI]] to set your account.
  
=== Modules ===
+
Run {{ic|prey_project config activate}} as prey user to ensure that the configuration is correct.
To enable/disable modules, you must change the executable permissions for the the "run" files in prey's respective modules/core subdirectories. Adding executable permissions to a module will enable it, while removing permissions will disable the module.
+
  
=== GUI config ===
+
The installer enable automatically the [[systemd]] service '''prey-agent''' to start Prey at boot. You can check if it's loaded and running with {{ic| systemctl status prey-agent}}
  
You can use a GUI to configure prey using the {{ic|prey-config}} script:
+
=== Plugins ===
  
{{bc|# sudo /usr/share/prey/platform/linux/prey-config.py}}
+
To enable/disable plugins, you must run {{ic|prey_project config plugins}} and read the usage to enable/disable and list the available plugins.
  
Note that if this doesn't work you are missing a dependency, not sure if python alone suffices.
+
=== GUI config ===
  
=== Standalone Mode ===
+
You can use a GUI to configure prey using the {{ic|prey_project config gui}} command:
  
The GUI can be used to configure standalone mode.
+
# prey_project config gui
  
Alternatively,{{ic|/usr/share/prey/config}} can be edited to change {{ic|post_method}} to {{ic|email}} and edit the SMTP settings.
+
=== Standalone Mode ===
  
Note that in Standalone Mode, all modules in {{ic|/usr/share/prey/modules}} run by default. To disable them, remove executable permissions on the module's {{ic|run}} file (located within the module's {{ic|core}} subdirectory). For example, the following command disables the {{ic|alarm}} module:
+
By enabling '''url-trigger''' and '''report-to-inbox''' plugins you can set a standalone prey client, triggering emailed reports whenever a URL returns a specific status code.
{{bc|# chmod -x /usr/share/prey/modules/alarm/core/run}}
+
  
 
=== Troubleshooting ===
 
=== Troubleshooting ===
 
To troubleshoot, run
 
To troubleshoot, run
  
{{bc|# /usr/share/prey/prey.sh --check}}
+
{{bc|$ prey_project config check}}
 +
 
 +
Ensure you have enabled [[systemd]] service '''prey-agent.service''' to start Prey at boot.
 +
 
 +
If you're not receiving webcam images in you reports, install {{Pkg|xawtv}} from the official repositories.
  
 
==== Beeping ====
 
==== Beeping ====
If [[Taking_a_Screenshot#scrot|scrot]] is installed, prey will use it to take a screenshot if the {{ic|session}} module is enabled. Unfortunately, scrot emits an annoying beep everytime it is run. To disable beeping, append {{ic|xset -b}}
+
If [[Taking a screenshot#scrot|scrot]] is installed, prey will use it to take a screenshot if the {{ic|session}} module is enabled. Unfortunately, scrot emits an annoying beep everytime it is run. To disable beeping, append {{ic|xset -b}}
 
to the beginning of {{ic|/usr/share/prey/modules/session/core/run}}.
 
to the beginning of {{ic|/usr/share/prey/modules/session/core/run}}.
  
 
=== Bugs ===
 
=== Bugs ===
 
There seems to be a bug in version 0.5.3 which gives an error if the SMTP password is set when using "email" post_method, which returns an error, but works fine when executed normally without the --check option.
 
There seems to be a bug in version 0.5.3 which gives an error if the SMTP password is set when using "email" post_method, which returns an error, but works fine when executed normally without the --check option.

Latest revision as of 07:40, 17 July 2016

Prey is a set of scripts that helps you track your computer when it is stolen.

This guide shows you how to install Prey.

Installation

Install prey-node-clientAUR from the AUR.

Configuration

Note: It is no longer possible to add new devices using the control panel on Prey's website. Use the Node.js client or the GUI.

First you must to have a Prey's account, if you don't have it, you can create it on the website. To add your device, run prey_project config account setup and type your email account and password. Or use the the GUI to set your account.

Run prey_project config activate as prey user to ensure that the configuration is correct.

The installer enable automatically the systemd service prey-agent to start Prey at boot. You can check if it's loaded and running with systemctl status prey-agent

Plugins

To enable/disable plugins, you must run prey_project config plugins and read the usage to enable/disable and list the available plugins.

GUI config

You can use a GUI to configure prey using the prey_project config gui command:

# prey_project config gui

Standalone Mode

By enabling url-trigger and report-to-inbox plugins you can set a standalone prey client, triggering emailed reports whenever a URL returns a specific status code.

Troubleshooting

To troubleshoot, run

$ prey_project config check

Ensure you have enabled systemd service prey-agent.service to start Prey at boot.

If you're not receiving webcam images in you reports, install xawtv from the official repositories.

Beeping

If scrot is installed, prey will use it to take a screenshot if the session module is enabled. Unfortunately, scrot emits an annoying beep everytime it is run. To disable beeping, append xset -b to the beginning of /usr/share/prey/modules/session/core/run.

Bugs

There seems to be a bug in version 0.5.3 which gives an error if the SMTP password is set when using "email" post_method, which returns an error, but works fine when executed normally without the --check option.