mirror of
https://github.com/skidoodle/iphistory.git
synced 2025-02-15 08:29:16 +01:00
Create readme.md
This commit is contained in:
parent
56747c2e97
commit
470ceae9ca
1 changed files with 57 additions and 0 deletions
57
readme.md
Normal file
57
readme.md
Normal file
|
@ -0,0 +1,57 @@
|
||||||
|
# IPHistory
|
||||||
|
|
||||||
|
The IPHistory project is a simple yet effective solution for tracking and logging the public IP address of your machine. It periodically fetches the public IP address and logs it to a file, while also providing a web interface to view the IP history in a clean UI and an endpoint (`/history`) for JSON format.
|
||||||
|
|
||||||
|
## Running Locally
|
||||||
|
|
||||||
|
### With Docker
|
||||||
|
|
||||||
|
```sh
|
||||||
|
git clone https://github.com/yourusername/iphistory
|
||||||
|
cd iphistory
|
||||||
|
docker build -t iphistory:main .
|
||||||
|
docker run -p 8080:8080 iphistory:main
|
||||||
|
```
|
||||||
|
|
||||||
|
### Without Docker
|
||||||
|
|
||||||
|
```sh
|
||||||
|
git clone https://github.com/yourusername/iphistory
|
||||||
|
cd iphistory
|
||||||
|
go run main.go
|
||||||
|
```
|
||||||
|
|
||||||
|
## Deploying
|
||||||
|
|
||||||
|
### Docker Compose
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
version: '3.9'
|
||||||
|
services:
|
||||||
|
iphistory:
|
||||||
|
container_name: iphistory
|
||||||
|
image: 'ghcr.io/skidoodle/iphistory:main'
|
||||||
|
restart: unless-stopped
|
||||||
|
ports:
|
||||||
|
- '8080:8080'
|
||||||
|
volumes:
|
||||||
|
- data:/app
|
||||||
|
volumes:
|
||||||
|
data:
|
||||||
|
driver: local
|
||||||
|
```
|
||||||
|
|
||||||
|
### Docker Run
|
||||||
|
|
||||||
|
```sh
|
||||||
|
docker run \
|
||||||
|
-d \
|
||||||
|
--name=iphistory \
|
||||||
|
--restart=unless-stopped \
|
||||||
|
-p 8080:8080 \
|
||||||
|
ghcr.io/skidoodle/iphistory:main
|
||||||
|
```
|
||||||
|
|
||||||
|
## License
|
||||||
|
|
||||||
|
[MIT](https://github.com/skidoodle/iphistory/blob/main/license)
|
Loading…
Add table
Add a link
Reference in a new issue