Skip to content

guumaster/hostctl

Repository files navigation

Tests GitHub Release Go Report Card License All Contributors Coverage

hostctl

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

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:

Or you can start directly on the Docs homepage.

Sample Usage

sample usage

Installation

Go to release page and download the binary you prefer.

Or read about other installation methods on different systems here

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.

Contributing

Be sure to read CONTRIBUTING and CODE_OF_CONDUCT.

Contributors ✨

Thanks goes to these wonderful people (emoji key):


George Kontridze

💻

Pacodes

⚠️ 💻

BarbUk

💻 🤔

Brett Mack

💻

Peter Thaleikis

💻 📖

simohamed

🤔 💻

Fabian Grutschus

🤔

This project follows the all-contributors specification. Contributions of any kind welcome!

Author(s)

LICENSE

MIT license