From 10661321b64082e658ce2edfc41b510a0e50148e Mon Sep 17 00:00:00 2001
From: Brian Carrier <carrier@sleuthkit.org>
Date: Tue, 1 May 2018 18:13:52 -0400
Subject: [PATCH] Added Linux / OS X instructions

---
 Running_Linux_OSX.txt | 41 +++++++++++++++++++++++++++++++++++++++++
 build.xml             |  1 +
 2 files changed, 42 insertions(+)
 create mode 100644 Running_Linux_OSX.txt

diff --git a/Running_Linux_OSX.txt b/Running_Linux_OSX.txt
new file mode 100644
index 0000000000..dc9c29a51a
--- /dev/null
+++ b/Running_Linux_OSX.txt
@@ -0,0 +1,41 @@
+This document outlines how to run a packaged version of Autopsy on Linux or OS X.  It does not cover how to compile it from source or the Windows installer. 
+
+
+* Prerequisites *
+
+The following need to be done at least once. They do not need to be repeated for each Autopsy release.
+
+- Install testdisk for photorec functionality
+-- Linux:  % sudo apt-get install testdisk
+-- OS X: % brew install testdisk
+
+- Install Oracle Java and set JAVA_HOME. 
+-- Linux: Use the instructions here: https://medium.com/coderscorner/installing-oracle-java-8-in-ubuntu-16-10-845507b13343
+-- OS X: Use The Oracle website: https://www.java.com/
+         Set JAVA_HOME with something like: export JAVA_HOME=`/usr/libexec/java_home` in .bash_profile
+
+
+* Install The Sleuth Kit Java Bindings *
+
+Autopsy depends on a specific version of The Sleuth Kit.  You need the Java libraries of The Sleuth Kit installed, which is not part of all packages. 
+
+- Linux: Install the sleuthkit-java.deb file that you can download from github.com/sleuthkit/sleuthkit/releases.  This will install libewf, etc. 
+-- % sudo apt install ./sleuthkit-java_4.6.0-1_amd64.deb
+
+- OS X: Install The Sleuth Kit from brew.  
+-- % brew install sleuthkit
+
+
+* Install Autopsy *
+
+- Extract the contents of the Autopsy ZIP file to a folder.
+- Open a terminal and cd into the Autopsy folder. 
+- Run the unix_setup.sh script to configure Autopsy
+  % sh unix_setup.sh
+
+
+* Running Autopsy *
+
+- In a terminal, change to the ‘bin’ directory in the Autopsy folder.
+- Run Autopsy
+  % ./autopsy
\ No newline at end of file
diff --git a/build.xml b/build.xml
index 8381cec295..a1ff9d665a 100644
--- a/build.xml
+++ b/build.xml
@@ -91,6 +91,7 @@
         <copy file="${basedir}/LICENSE-2.0.txt" tofile="${zip-tmp}/${app.name}/LICENSE-2.0.txt"/>
         <copy file="${basedir}/NEWS.txt" tofile="${zip-tmp}/${app.name}/NEWS.txt"/>
         <copy file="${basedir}/KNOWN_ISSUES.txt" tofile="${zip-tmp}/${app.name}/KNOWN_ISSUES.txt"/>
+        <copy file="${basedir}/Running_Linux_OSX.txt" tofile="${zip-tmp}/${app.name}/Running_Linux_OSX.txt"/>
         <copy file="${basedir}/unix_setup.sh" tofile="${zip-tmp}/${app.name}/unix_setup.sh"/>
         <replaceregexp file="${zip-tmp}/${app.name}/unix_setup.sh" match="TSK_VERSION=(.*)" replace="TSK_VERSION=${TSK_VERSION}" byline="true"/>
         <unzip src="${thirdparty.dir}/gstreamer/windows/i386/0.10.7/gstreamer.zip" dest="${zip-tmp}/${app.name}/gstreamer"/>