So, you have axiom installed, you're feeling pretty good about yourself, you're 10 minutes away from feeling the power of axiom!
If you've followed the installation steps with success, you should have run the axiom-configure
script at some point. During this configuration, packer
will be run and a machine snapshot will be created. You should notice "Shutting down gracefully... Creating snapshot....".
You should have a valid build in your account now, if, in doubt, you can run axiom-build
and create a new base snapshot just in case!
We currently offer three different base images you can provision. Our Default provisioner comes with tools to run most modules. The ReconFTW provisioner comes with all tools installed and the Barebones provisioner comes with no tools installed. If you want to bring-you-own Packer JSON provisioner, select custom.
axiom-build
Before you can interact with axiom, you first have to initialize a new instance.
axiom-init
You can run this command without any parameters, and it will pick a name for you. This name is picked at random from a list of legends!
# axiom-init <instance name>
axiom-init jerry
If you supply an argument, it will be used as the instance name, in the above example we spin up an instance called "jerry".
Now you have spun up an instance, you can run axiom-ls
and get a list of all running instances.
axiom-ls
This will list your running instances and a monthly-cost estimate for each instance.
Now you have an instance, and it has a public IP address, you can connect to your new instance using axiom-ssh
# axiom-ssh <instance>
axiom-ssh jerry
If you want to be dropped into a tmux session, that will remain after you disconnect, use the --tmux
flag.
axiom-ssh jerry --tmux
To detach from this tmux session, run ctrl+a d
, this will disconnect you from the box but leave your tmux session running (and any command running in that session!)
After running axiom-init you can set up config files, unique wordlists, private tools etc, take a snapshot of that image and use it to deploy future axiom instances/fleets.
axiom-backup jerry
Once you're done with your instance, delete it using the command, axiom-rm <instance>
axiom-rm jerry
# or
axiom-rm jerry -f
The -f flag will not prompt on deletion, I generally use this, but if you want to be ultra sure omit the -f
flag.
In Summary, a few useful commands to get you up and running, to use basic instances, and interact with them. Please refer to the other guides in the sidebar.