This project is an attempt to packaging the Ananta with its runtime into a minimum, hardened docker image, while also providing a convenient way to use it.
It is recommended to bind mount the ${HOME}/.ssh/
into the container, and the container will automatically generate hosts.toml
based on ~/.ssh/config
for you.
Since it is routine for me to spend lot of my labour hours in an air-gapped environment, a docker image seems to be the best way to package some of my favourite tools.
Install the ananta
helper script:
curl -sSLROJ --fail -- \
"https://github.com/IceCodeNew/anata-no-minato/releases/latest/download/ananta"
# it is always a good idea to check the content of a script before executing it
cat ./ananta
sudo install -pvD ./ananta /usr/local/bin/
rm ./ananta
This helper script will automatically generate hosts.toml based on ~/.ssh/config
, issue the command as below:
(omit the hosts.toml argument)
ananta -CS fastfetch
In case you want to specify an existing hosts.toml,
issue the command with the same arguments sequence as the original ananta command:
ananta -t arch hosts.toml sudo pacman -Syu --noconfirm
You can assign tags to hosts by including a #tags
line in your SSH config. Separate multiple tags using either commas (,
) or colons (:
), as shown below:
Host mynas
Hostname 1.1.1.1
User root
#tags tailscale,debian:nas,home
To exclude a host from the generated hosts.toml
file, add the !ananta
tag to its tags list. Any host marked with this tag will be skipped during the generation process.
Host do_not_ananta_in_this_host
#tags home,debian,!ananta
To disable a #tags
line, simply add an extra #
at the beginning, effectively re-enabling the SSH host.
Host will_ananta_in_this_host
##tags home,debian,!ananta
My local disk already has too many git repositories named docker-XXX
. Since I want to save a few keystrokes when jumping into this project directory, I won't name it docker-ananta
.
Ananta
doesn't align with Chinese or Japanese pronunciation conventions. By omitting one 'n' it becomes the Japanese word Anata
(あなた), which means "you" and gives me tab completion after typing just four letters.
Meanwhile, Minato
(みなと) in Japanese means "harbor" - a natural association with Docker containers. When combined, these form the title of a classic Japanese enka song. Please take a listen to it ;-)