plausible-pageviews-api/README.md
Sangelo b37326f215
Some checks failed
Build and Push Docker Image / build-and-push (push) Has been cancelled
[a] docker container and workflow
2024-10-21 15:29:20 +02:00

37 lines
964 B
Markdown

# plausible-pageviews-api
Get the requested page's views or unique visitors from Plausible Analytics.
## Configuration in `.env`
```env
PORT=3000 # the api port
METRICS_PORT=9100 # the port on which prometheus metrics are hosted on, endpoint: /metrics
PLAUSIBLE_DOMAIN=plausible.io # the plausible instance domain
PLAUSIBLE_API_KEY="api_key_goes_here" # your plausible API key
ALLOWED_ORIGINS="https://example.com" # allowed CORS origins
RATE_LIMIT_MINUTES=15 # the amount of time in minutes to rate limit
RATE_LIMIT_REQUESTS=100 # amount of max. requests
```
Don't change the `PORT` value when running in a Docker Container. Instead, export a different port and forward that to the container's port `3000`.
```yml
# example for docker-compose.yml:
ports:
- "5678:3000"
```
You also have to mount the `.env` file inside the container, if you're using Docker:
```yml
volumes:
- .env:/app/.env
```
## Run the API
```bash
$ yarn install
$ yarn start
```