diff --git a/README.md b/README.md
new file mode 100644
index 0000000..ae37de2
--- /dev/null
+++ b/README.md
@@ -0,0 +1,100 @@
+# FabricExporter
+
+![](https://img.shields.io/github/license/RuscalWorld/FabricExporter)
+![](https://img.shields.io/github/workflow/status/RuscalWorld/FabricExporter/Build)
+
+Fabric mod that adds a Prometheus exporter with general metrics of your server.
+
+![Grafana Dashboard](https://img.share.superhub.xyz/2oiycx.png)
+
+---
+
+It's a server-side mod that exposes metrics of your Fabric server in [Prometheus](https://prometheus.io) format.
+So, it requires you to have at least Prometheus installed to collect provided metrics.
+I recommend also using [Grafana](https://grafana.com) to visualize data.
+
+If you want to get TPS and MSPT metrics, you should also install [Spark](https://spark.lucko.me) as mod for your Fabric server.
+
+## Exposed metrics
+
+Here is a list of metrics that are collected by FabricExporter.
+
+* Metrics collected by Minecraft doesn't require anything, but may cause errors when running on old Minecraft versions
+* Metrics collected by [Spark](https://spark.lucko.me) require Spark to be installed
+
+You can disable any of these metrics in [config](src/main/resources/config/exporter.properties).
+
+| Prometheus name | Description | Config property | Collected by |
+| --------------- | ----------- | --------------- | ------------ |
+| `minecraft_loaded_chunks` | Amount of currently loaded chunks on server | `enable-loaded-chunks` | Minecraft |
+| `minecraft_total_loaded_chunks` | Amount of total loaded chunks on server | `enable-total-loaded-chunks` | Minecraft |
+| `minecraft_mspt` | Count of milliseconds per tick (MSPT) | `enable-mspt` | Spark |
+| `minecraft_tps` | Count of ticks per second (TPS) | `enable-tps` | Spark |
+| `minecraft_players_online` | Amount of currently online players on your server | `enable-players-online` | FabricExporter |
+| `minecraft_entities` | Amount of currently loaded entities on your server | `enable-entities` | FabricExporter |
+| `minecraft_handshakes` | Count of handshake requests | `enable-handshakes` | FabricExporter |
+
+## Getting started
+
+To use this mod you should have at least Fabric server and Prometheus installed.
+
+### Installing mod
+
+1. Download the mod from [Releases](https://github.com/RuscalWorld/FabricExporter/releases) page.
+2. Drop downloaded mod jar to the `mods` folder.
+3. Start your server to generate config file.
+4. Open `config/exporter.properties`, ensure that `server-port` value is an open port that can be accessed by your Prometheus and change it if required.
+5. Restart the server if you made changes in config.
+
+### Configuring Prometheus
+
+1. Open your Prometheus config file (it located at `/etc/prometheus/prometheus.yml` by default).
+```bash
+sudo nano /etc/prometheus/prometheus.yml
+```
+2. Add FabricExporter endpoint to the `scrape_configs` section. 
+Don't forget to replace `127.0.0.1` with address of your server and `25585` with port specified in `server-port` property in `exporter.properties` file.
+```YAML
+- job_name: 'fabric'
+  static_configs:
+    - targets: ['127.0.0.1:25585']
+```
+3. Restart Prometheus service.
+```bash
+sudo service prometheus restart
+```
+
+### Importing Grafana dashboard
+If you want to use Grafana, you can use my dashboard as template. 
+I assume that you have already [created a Prometheus data source](https://prometheus.io/docs/visualization/grafana/) in Grafana.
+So, let's import [dashboard for FabricExporter](https://grafana.com/grafana/dashboards/14492).
+
+1. Log in to your Grafana and go to `Create -> Import` tab.
+2. Type `14492` in "Import via grafana.com" field and click "Load".
+3. On the next page change settings as you wish and click "Import".
+
+## Configuring
+
+After your server starts, FabricExporter will create `exporter.properties` file in the `config` folder. 
+You should use this file to configure the mod.
+In this file you can see some general settings and metrics settings.
+
+### General settings
+
+| Property | Description | Default value |
+| -------- | ----------- | ------------- |
+| `server-port` | Port on what the web server will listen for requests | `25585` |
+| `update-interval` | Interval between gauge metrics updates in milliseconds | `1000` |
+| `use-spark` | If set to `false`, FabricExporter will be independent from Spark | `true` |
+
+### Metrics settings
+
+You can disable any metric that registered via MetricRegistry (all metrics by default) using the settings below.
+Names of properties consist of `enabled` and metric name without prefix and `_` replaced with `-`.
+For example, if you want to disable `minecraft_players_online`, you should set `enable-players-online` to `false`.
+You can also see list of available properties in "Exposed metrics" section.
+If you can't find property for some metrics, you can manually add it.
+All metrics are enabled by default.
+
+## License
+MIT license. Read more in [LICENSE](LICENSE)