mirror of
https://github.com/telekom-security/tpotce.git
synced 2025-04-28 19:28:50 +00:00
46 lines
2.1 KiB
Markdown
46 lines
2.1 KiB
Markdown
# T-Pot Community Edition Image Creator
|
|
|
|
This repository contains the necessary files to create the **[T-Pot community honeypot](http://dtag-dev-sec.github.io/)** ISO image.
|
|
The image can then be used to install T-Pot on a physical or virtual machine.
|
|
|
|
### Image Creation
|
|
**Requirements to create the ISO image:**
|
|
- Ubuntu 14.04.2 or 14.10 as host system (others *may* work, but remain untested)
|
|
- 2GB of free memory
|
|
- 4GB of free storage
|
|
- A working internet connection
|
|
|
|
**How to create the ISO image:**
|
|
|
|
1. Clone the repository and enter it.
|
|
|
|
git clone https://github.com/dtag-dev-sec/tpotce.git
|
|
cd tpotce
|
|
|
|
2. Invoke the script that builds the ISO image.
|
|
The script will download and install dependecies necessary to build the image on the invoking machine. It will further download the ubuntu base image (~600MB) which T-Pot is based on.
|
|
|
|
sudo ./makeiso.sh
|
|
After successful build, you will find the ISO image `tpotce.iso` in your directory.
|
|
|
|
|
|
###Prebuilt ISO Image
|
|
If you don't want to build the image yourself, you can download the prebuilt [tpotce.iso](http://community-honeypot.de/tpotce.iso) ISO image from the project's web page.
|
|
|
|
###Installation
|
|
When installing the T-Pot ISO image, make sure the target system (physical/virtual) meets the following minimum requirements:
|
|
- 2 GB RAM (4 GB recommended)
|
|
- 40 GB disk (64 GB SSD recommended)
|
|
- Network via DHCP
|
|
- A working internet connection
|
|
|
|
The installation requires very little interaction. Most things should be configured automatically. The system will reboot a couple of times. Make sure it can access the internet as it needs to download the dockerized honeypot components. Depending on your network connection, the installation may take some time.
|
|
Once the installation is finished, the system will automatically reboot and you will be presented with a login screen. The user credentials for the first login are:
|
|
- user: tsec
|
|
- pass: tsec
|
|
|
|
You will need to set a new password after first login.
|
|
|
|
All honeypot services are started automatically.
|
|
|
|
For further information and a more in depth installation instruction, visit [T-Pot's website](http://dtag-dev-sec.github.io/).
|