https://github.com/http-server-rs/http-server

Simple and configurable command-line HTTP server
https://github.com/http-server-rs/http-server

cli file http http-server https proxy rust server-side static

Last synced: 2 months ago
JSON representation

Simple and configurable command-line HTTP server

• Host: GitHub
• URL: https://github.com/http-server-rs/http-server
• Owner: http-server-rs
• License: apache-2.0
• Created: 2020-10-04T14:17:01.000Z (about 5 years ago)
• Default Branch: main
• Last Pushed: 2025-08-20T23:21:01.000Z (4 months ago)
• Last Synced: 2025-10-12T15:44:24.733Z (3 months ago)
• Topics: cli, file, http, http-server, https, proxy, rust, server-side, static
• Language: Rust
• Homepage: https://crates.io/crates/http-server
• Size: 2.42 MB
• Stars: 209
• Watchers: 3
• Forks: 22
• Open Issues: 14
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE-APACHE
  • Code of conduct: CODE_OF_CONDUCT.md
  • Security: SECURITY.md
  • Authors: AUTHORS

Awesome Lists containing this project

README

          


  


    

  

  
http-server

  
Simple and configurable command-line HTTP server





[![Crates.io](https://img.shields.io/crates/v/http-server.svg)](https://crates.io/crates/http-server)

[![Documentation](https://docs.rs/http-server/badge.svg)](https://docs.rs/http-server)

![Build](https://github.com/http-server-rs/http-server/workflows/build/badge.svg)

![Clippy](https://github.com/http-server-rs/http-server/workflows/clippy/badge.svg)

![Formatter](https://github.com/http-server-rs/http-server/workflows/fmt/badge.svg)

![Tests](https://github.com/http-server-rs/http-server/workflows/test/badge.svg)

![Benches](https://github.com/http-server-rs/http-server/workflows/bench/badge.svg)



## Development

### Release Build

Build release binaries with:

```bash

make release

```

Then use the following _alias_ for convenience

```bash

alias htps = './target/release/http-server'

```

## Release

In order to create a release you must push a Git tag as follows

```sh

git tag -a  -m 

```

**Example**

```sh

git tag -a v0.1.0 -m "First release"

```

> Tags must follow semver conventions.

> Tags must be prefixed with a lowercase `v` letter.

Then push tags as follows:

```sh

git push origin main --follow-tags

```

## Contributing

Every contribution to this project is welcome. Feel free to open a pull request or

an issue. Just by using this project you're helping it grow. Thank you!

## License

Distributed under the terms of both the MIT license and the Apache License (Version 2.0)

[1]: https://github.com/http-server-rs/http-server