elmasy

KO | EN

gitlite — search

#typescript #ai-agents #ai #dsh-plugin #deepseek-harness #open-source #claude-code #codex #cli #developer-tools #react #windows

★ 49 Open GitHub ↗

Open Source External Attack Surface Management

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# elmasy

![Go Report Card](https://goreportcard.com/badge/github.com/elmasy-com/elmasy)

Elmasy *will be* an attack surface analysis tool.
Discover and assess as many as possible publicly accessible assets from a domain name.

This project has 3 goals:

- To provide a website for non-professionals/professionals to check the attack surfaces of publicly accessible assets.
- To provide an API for professionals to work with easily. 
  - The website will use the same API as your service.
- To provide a wide range of libraries for professionals to work with without relying on external services. 
  - The API will use the same libraries as you.

As we grow, we will know more protocols, more services and assess/evaluate as fast as the programming language allows. The project is starts from lower layers (like TCP and UDP), basic services (like web servers) and gathering basic information about the servers (like TLS ciphers).

## Install

```bash
wget https://raw.githubusercontent.com/elmasy-com/elmasy/main/scripts/install.sh
```

```bash
sudo bash install.sh install
```

```bash
cp /opt/elmasy/elmasy.conf.example /opt/elmasy/elmasy.conf
```

Edit the config file.

## Run

### Systemd

The installer create a service for Elmasy.

To start:

```bash
systemctl start elmasy
```

### Manual

If `-config` not specified, Elmasy look for the config file in the current directory.

```bash
cd /opt/elmasy && ./elmasy
```

## Update

```bash
sudo bash install.sh updateself && sudo bash install.sh install
```

NOTE: If Elmasy was running before update, the `install` command will restart automatically.

## Author

[System administrator service and Cybersecurity for small and medium-sized businesses in and around Győr.](https://www.gorbe.io/)

elmasy

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README