You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+28-18Lines changed: 28 additions & 18 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,7 +2,6 @@
2
2
3
3
[portchecker.io](https://portchecker.io) is an open-source API for checking port availability on specified hostnames or IP addresses. Ideal for developers and network admins, it helps troubleshoot network setups, validate firewall rules, and assess potential access points.
4
4
5
-
6
5
## Table of contents:
7
6
8
7
-[Getting Started](#getting-started)
@@ -15,78 +14,87 @@
15
14
-[Contributing](#contributing)
16
15
17
16
## Getting Started
17
+
18
18
The project consists of two containers. The front-end is a static HTML file sat behind Nginx. The back-end is a simple API built using [Litestar](https://litestar.dev/).
19
19
20
20
The project aims to be super simple, with low overhead and also the least amount of dependencies as possible.
21
21
22
22
The project contains both production and development stacks. The production stack utilises `gunicorn` as the API's process manager with `uvicorn` workers. Development utilises `uvicorn` with the `--reload` parameter.
23
23
24
24
## Documentation
25
-
API routes and specification can be found at [portchecker.io/docs](https://portchecker.io/docs)
26
25
26
+
API routes and specification can be found at [portchecker.io/docs](https://portchecker.io/docs)
27
27
28
28
## Development
29
29
30
30
### Standalone
31
31
32
32
#### Web
33
+
33
34
> [!NOTE]
34
35
> Uses [Node](https://nodejs.org/) version 23 and newer. Requires [Yarn](https://classic.yarnpkg.com/en/)
35
36
36
37
Bringing up the UI outside of Docker;
37
-
~~~
38
+
39
+
```
38
40
$ cd frontend/web
39
41
$ yarn install
40
42
$ yarn dev
41
-
~~~
43
+
```
42
44
43
45
portchecker.io front-end be running at [http://0.0.0.0:8080](http://0.0.0.0:8080).
44
46
45
47
#### API
48
+
46
49
> [!NOTE]
47
50
> Uses Python 3.12. The Python environment uses [Poetry](https://pypi.org/project/poetry/) for package management. This must be installed.
portchecker.io API be running at [http://0.0.0.0:8000](http://0.0.0.0:8000).
56
59
57
-
58
60
### Docker
59
-
~~~
61
+
62
+
```
60
63
$ docker-compose -f docker-compose-dev.yml up --build
61
-
~~~
64
+
```
62
65
63
66
portchecker.io front-end will be running at [http://0.0.0.0:8080](http://0.0.0.0:8080) and the API will be running at [http://0.0.0.0:8000](http://0.0.0.0:8000).
64
67
65
68
## Production
69
+
66
70
### Docker
71
+
67
72
> [!NOTE]
68
73
> Uses [ghcr.io/dsgnr/portcheckerio-web:latest](https://github.com/dsgnr/portchecker.io/pkgs/container/portcheckerio-web) and [ghcr.io/dsgnr/portcheckerio-api:latest](https://github.com/dsgnr/portchecker.io/pkgs/container/portcheckerio-api).
69
74
70
-
~~~
75
+
```
71
76
$ docker-compose up
72
-
~~~
77
+
```
73
78
74
79
portchecker.io front-end will be running at [http://0.0.0.0:8080](http://0.0.0.0:8080) and the API will be running at [http://0.0.0.0:8000](http://0.0.0.0:8000).
75
80
76
81
## Environment Variables
82
+
77
83
The following configuration options are available. These would be set within the Docker compose files, or in your environment if you're using portchecker standalone.
| ALLOW_PRIVATE | No | False | Allows private IP addresses in [ IANA IPv4 Special Registry ](https://www.iana.org/assignments/iana-ipv4-special-registry/iana-ipv4-special-registry.xhtml) ranges to be checked |
| ALLOW_PRIVATE | No | False | Allows private IP addresses in [ IANA IPv4 Special Registry ](https://www.iana.org/assignments/iana-ipv4-special-registry/iana-ipv4-special-registry.xhtml) ranges to be checked |
90
98
91
99
## Contributing
92
100
@@ -95,10 +103,12 @@ I'm thrilled that you’re interested in contributing to this project! Here’s
95
103
### How to Contribute
96
104
97
105
1.**Submit Issues**:
106
+
98
107
- If you encounter any bugs or have suggestions for improvements, please submit an issue on our [GitHub Issues](https://github.com/dsgnr/portchecker.io/issues) page.
99
108
- Provide as much detail as possible, including steps to reproduce and screenshots if applicable.
100
109
101
110
2.**Propose Features**:
111
+
102
112
- Have a great idea for a new feature? Open a feature request issue in the same [GitHub Issues](https://github.com/dsgnr/portchecker.io/issues) page.
103
113
- Describe the feature in detail and explain how it will benefit the project.
104
114
@@ -122,8 +132,8 @@ Where this project has been mentioned.
0 commit comments