GitHub Go Report Card

Linux systems derive user and group information from the /etc/passwd and /etc/group files by default. The localizer utility edits these files for you to add and remove users that are present in the NetAuth system to your Linux computers.


If your distribution provides a packaged binary form of localize, you are strongly encouraged to use this, though if your distribution happens to be Debian derived, make sure you’re getting a version that’s somewhat recent.

If your distribution does not provide localize, you’ll need to build it from source. It is assumed that you have a Go installation of version 1.13 or later.

Now you can build localize:

$ git clone -b <version> https://github.com/NetAuth/localizer
$ cd localizer
$ go build -o localize cmd/localize/main.go

Now you can install localize.

$ sudo cp localize /usr/local/sbin/
$ sudo chown root:root /usr/local/sbin/localize
$ sudo chmod 0755 /usr/local/sbin/localize

Remember to update your build periodically to ensure you have appropriate security fixes.


Running the binary as root will do the right thing, assuming that you have your certificate located at /etc/netauth.cert and your configuration file at /etc/netauth.toml.

localize can be configured via flags. Important flags you may need to override are provided below:

localize provides single shot updates to the system. You must run localize on some sort of job controller if you want to keep the local system up to date with the information contained in NetAuth. Choose the update frequency that is right for you. A good default choice if you have no idea what to set here is 30 minutes. This will be slightly annoying to users that have just been created in the system, but won’t otherwise cause undue load on the NetAuth server.