Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/guumaster/hostctl

Your dev tool to manage /etc/hosts like a pro!
https://github.com/guumaster/hostctl

cli developer-tools dns etchosts go golang hosts-file hostsfile localhost-management

Last synced: about 22 hours ago
JSON representation

Your dev tool to manage /etc/hosts like a pro!

Host: GitHub
URL: https://github.com/guumaster/hostctl
Owner: guumaster
License: mit
Created: 2020-03-14T11:29:02.000Z (almost 5 years ago)
Default Branch: master
Last Pushed: 2024-01-26T21:11:34.000Z (12 months ago)
Last Synced: 2025-01-04T04:07:01.085Z (8 days ago)
Topics: cli, developer-tools, dns, etchosts, go, golang, hosts-file, hostsfile, localhost-management
Language: Go
Homepage: http://guumaster.github.io/hostctl
Size: 3.45 MB
Stars: 1,114
Watchers: 14
Forks: 48
Open Issues: 20
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

go-awesome - hostctl - `hosts` command line management tool (Open source library / Word Processing)
awesome-golang-repositories - hostctl
awesome-tools - hostctl - Your dev tool to manage /etc/hosts like a pro! (Uncategorized / Uncategorized)
awesome-go-extra - hostctl - 03-14T11:29:02Z|2022-08-24T14:25:48Z| (Utilities / Fail injection)
web-stuff - HostCtl - library to manage /etc/hosts (see [How I force myself to work](https://peterthaleikis.com/posts/how-i-force-myself-to-work/)) (Bash)
awesome-go - hostctl - A CLI tool to manage /etc/hosts with easy commands. Stars:`1.1K`. (Utilities / Utility/Miscellaneous)

README

        [![Tests][tests-badge]][tests-link]

[![GitHub Release][release-badge]][release-link]

[![Go Report Card][report-badge]][report-link]

[![License][license-badge]][license-link]

[![All Contributors][all-contributors-badge]][all-contributors-link]

[![Coverage][coverage-badge]][coverage-link]

[![Mentioned in Awesome Go][awesome-go-badge]][awesome-go-link]

# hostctl

[![Your dev tool to manage /etc/hosts like a pro!](docs/hostctl.png)](http://guumaster.github.io/hostctl/)

This tool gives you more control over the use of your hosts file. 

You can have multiple profiles and switch them on/off as you need.

## Why?

It is a tedious task to handle the `hosts` file by editing manually.

With this tool you can automate some aspects to do it cleaner and quick. 

## Features

  * Manage groups of host names by profile.

  * Enable/disable complete profiles.

  * Add/remove groups of host names.

  * Add profiles directly from a text file that you can add to your git repo or any VCS.

  * Sync a profile with Docker or Docker Compose containers.

  

## Documentation

You can read about how to use this tool here:

* [Getting started guide](http://guumaster.github.io/hostctl/docs/getting-started/) 

* [Usage Guides](http://guumaster.github.io/hostctl/docs/guides/)

* [CLI commands, options and flags](http://guumaster.github.io/hostctl/docs/cli-usage/)

Or you can start directly on the [Docs homepage](http://guumaster.github.io/hostctl/).

## Sample Usage

![sample usage](docs/hostctl.gif)

## Installation

Go to [release page](https://github.com/guumaster/hostctl/releases) and download the binary you prefer.

Or read about other installation methods on different systems [here](http://guumaster.github.io/hostctl/docs/installation/)

## Linux/Mac/Windows and permissions

The tool recognize your system and use the right hosts file, it will use `/etc/hosts` on Linux/Mac and `C:/Windows/System32/Drivers/etc/hosts` on Windows.

**SUDO/ADMIN**: You will need permissions for any action that modify hosts file, add `sudo` to the commands below when needed. If you are on windows, make sure you run it as administrator.

**WARNING**: it should work on any system. It's tested on Ubuntu and Windows 10. If you can confirm it works on other system, please let me know [here](https://github.com/guumaster/hostctl/issues/new).

## Contributing

Be sure to read [CONTRIBUTING](CONTRIBUTING.md) and [CODE_OF_CONDUCT](CODE_OF_CONDUCT.md).

## Contributors ✨

Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):

  

    
_{George Kontridze}
💻

    
_Pacodes
⚠️ 💻

    
_BarbUk
💻 🤔

    
_{Brett Mack}
💻

    
_{Peter Thaleikis}
💻 📖

    
_simohamed
🤔 💻

    
_{Fabian Grutschus}
🤔

    
_{Pablo Caderno}
💻

    
_{Josh Brown}
🐛

    
_{Lukas M}
🐛 🤔

  

This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!

## Author(s)

* [guumaster](https://github.com/guumaster)

If you like this tool and think is worth it, you can invite me a coffee: 

[![paypal.me/guumaster][paypal-badge]][paypal-link]

[![ko-fi.com/guumaster][kofi-badge]][kofi-link]

## LICENSE

 [MIT license](LICENSE)

[tests-badge]: https://img.shields.io/github/actions/workflow/status/guumaster/hostctl/tests.yml

[tests-link]: https://github.com/guumaster/hostctl/actions/workflows/tests.yml

[release-badge]: https://img.shields.io/github/release/guumaster/hostctl.svg?logo=github&labelColor=262b30

[release-link]: https://github.com/guumaster/hostctl/releases

[report-badge]: https://goreportcard.com/badge/github.com/guumaster/hostctl

[report-link]: https://goreportcard.com/report/github.com/guumaster/hostctl

[license-badge]: https://img.shields.io/github/license/guumaster/hostctl

[license-link]: https://github.com/guumaster/hostctl/blob/master/LICENSE

[coverage-badge]: https://sonarcloud.io/api/project_badges/measure?project=guumaster_hostctl&metric=coverage

[coverage-link]: https://sonarcloud.io/dashboard?id=guumaster_hostctl

[awesome-go-badge]: https://awesome.re/mentioned-badge.svg

[awesome-go-link]: https://github.com/avelino/awesome-go

[all-contributors-badge]: https://img.shields.io/badge/contributors-10-blue.svg

[all-contributors-link]: #contributors-

[paypal-link]: https://www.paypal.me/guumaster

[paypal-badge]: https://img.shields.io/static/v1?label=donate&message=PayPal&color=00457C&logo=paypal

[kofi-link]: https://ko-fi.com/guumaster

[kofi-badge]: https://img.shields.io/static/v1?label=donate&message=Ko-fi&color=F16061&logo=ko-fi