-
Notifications
You must be signed in to change notification settings - Fork 145
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
cmahrl
committed
May 2, 2023
1 parent
dd6c2b7
commit f27e1a1
Showing
297 changed files
with
7,568 additions
and
8,122 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,5 @@ | ||
.idea | ||
app.env | ||
**/app.env | ||
.DS_Store | ||
.scannerwork |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,30 +1,53 @@ | ||
# SysReptor | ||
## Getting started | ||
### Prerequisites | ||
<a href="https://github.com/syslifters/sysreptor/"> | ||
<img src="https://img.shields.io/github/stars/Syslifters/sysreptor?color=yellow&style=flat-square"> | ||
</a> | ||
<a href="https://github.com/syslifters/sysreptor/releases/latest"> | ||
<img src="https://img.shields.io/github/v/release/syslifters/sysreptor?color=green&style=flat-square"> | ||
</a> | ||
<a href="https://github.com/syslifters/sysreptor/releases/latest"> | ||
<img src="https://img.shields.io/github/release-date/syslifters/sysreptor?color=blue&style=flat-square"> | ||
</a> | ||
<a href="https://github.com/syslifters/sysreptor/releases/latest"> | ||
<img src="https://img.shields.io/github/repo-size/syslifters/sysreptor?color=red&style=flat-square"> | ||
</a> | ||
<a href="https://www.linkedin.com/company/syslifters/"> | ||
<img src="https://img.shields.io/badge/-Linkedin-blue?style=flat-square&logo=linkedin"> | ||
</a> | ||
<a href="https://twitter.com/intent/user?screen_name=sysreptor"> | ||
<img src="https://img.shields.io/twitter/follow/sysreptor?style=social"> | ||
</a><br> | ||
|
||
# SysReptor - Pentest Reporting Easy As Pie | ||
|
||
📝 Write in markdown | ||
✏️ Design in HTML/VueJS | ||
⚙️ Render your report to PDF | ||
🚀 Fully customizable | ||
💻 Self-hosted or Cloud | ||
🎉 No need for Word | ||
|
||
Happy Hacking! :) | ||
|
||
|
||
* Playground: [Try it out!](https://cloud.sysreptor.com/demo) | ||
* Docs: https://docs.sysreptor.com/ | ||
* Features: https://docs.sysreptor.com/features-and-pricing/ | ||
|
||
|
||
## Installation | ||
You will need: | ||
* Ubuntu | ||
* 8GB RAM for building the image (or 4GB + 8GB swap) | ||
* 4GB RAM for operating the server | ||
* Latest [Docker](https://docs.docker.com/engine/install/){ target=_blank } | ||
* Latest [Docker Compose](https://docs.docker.com/compose/install/){ target=_blank } | ||
* Latest Chrome, Edge, Firefox (Safari currently not officially supported) | ||
|
||
### Quick Install | ||
## Install | ||
```shell linenums="1" | ||
git clone https://github.com/Syslifters/sysreptor.git | ||
# Alternative via SSH: git clone [email protected]:Syslifters/sysreptor.git | ||
cd deploy | ||
cp app.env.example app.env | ||
# Update keys and credentials in app.env (e.g. SECRET_KEY) | ||
# Optionally update database credentials in docker-compose.yml | ||
docker compose up --build -d | ||
# This command might take a few minutes when you run it the first time | ||
# It is building your image and preparing all the nice stuff you will want to use | ||
docker compose exec app python3 manage.py createsuperuser | ||
# Now you have to specify your initial user's name and password | ||
* Latest Docker with Docker Compose v2 | ||
|
||
```bash | ||
curl -s https://docs.sysreptor.com/install.sh | bash | ||
``` | ||
|
||
You can now access your application with your favourite browser at http://localhost:8000/. | ||
Access your application at http://localhost:8000/. | ||
|
||
|
||
![Create finding from template](https://docs.sysreptor.com/images/create_finding_from_template.gif) | ||
|
||
![Export report as PDF](https://docs.sysreptor.com/images/export_project.gif) | ||
|
||
|
||
## Documentation | ||
Find further documentation (how to add users, etc) at [https://docs.sysreptor.com](https://docs.sysreptor.com) |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.