0 Installation

Easy Install

As a standard user with root privileges, run this command on any supported OS. The script will prompt for sudo when root when required.

bash <(curl -s https://raw.githubusercontent.com/pry0cc/axiom/master/interact/axiom-configure)

Using Git Clone

In most cases, the easy install should work, however, if you do want to install manually, this guide is your friend!

Ensure that ~/.axiom/ does not exist

rm -rf ~/.axiom/

Clone the axiom repository

git clone https://github.com/pry0cc/axiom ~/.axiom/

Run configure script

$HOME/.axiom/interact/axiom-configure

Manual

To install axiom on an OS that is not on our supported list, all you have to do is ensure that you have all the right dependencies and then run the configuration script.

Dependencies

• Digital Ocean API Key - (Personal Access Token) - https://cloud.digitalocean.com/account/api/tokens
• SSH Keypair (I recommend using a key without a passphrase for speed, even if used just for Axiom.)
• git
• curl
• ruby
• jq - 1.6
• packer - Tested with v1.5.6
• doctl
• Interlace - https://github.com/codingo/Interlace
• rsync
• lsb_release - Tested with 1.4 (but any version should be ok)
• fzf (If you want menus)

Troubleshooting

If an error is occurring recently, please run axiom-update successfully before reporting an issue.

If even after all these steps, it still isn't working, then use this checklist:

• Does ~/.axiom/axiom.json exist? Is it empty?
• Is doctl configured? Run doctl compute instances list to test, you may need to run doctl auth.
• Is axiom in your path? Run echo $PATH, your $PATH should contain ~/.axiom/interact/, this is the directory with all the scripts
• Are you using axiom correctly? Check the quick start guide!
• Is git complaining about un-mergable files on update? Delete the ones it complain about, then run the update again.
• Do you get an error about functions.sh? Run axiom-account-setup

---

Error after updating

.axiom/interact/axiom-ls: line 5: /home/pry/.axiom/interact/includes/functions.sh: No such file or directory

Fix

Run axiom-account to see what account profiles you have

axiom-account

Then run axiom-account <profile>

axiom-account personal

---

Error when Updating

$ axiom-update
remote: Enumerating objects: 10, done.
remote: Counting objects: 100% (10/10), done.
remote: Compressing objects: 100% (2/2), done.
Unpacking objects: 100% (6/6), 1012 bytes | 253.00 KiB/s, done.
remote: Total 6 (delta 3), reused 5 (delta 3), pack-reused 0
From github.com:pry0cc/axiom
   4c8e258..a2992f1  master     -> origin/master
Updating 4c8e258..a2992f1
error: Your local changes to the following files would be overwritten by merge:
	interact/includes/functions.sh
Please commit your changes or stash them before you merge.
Aborting

Fix

rm ~/.axiom/interact/includes/functions.sh
axiom-account <profile>

---

FAQ

I can't log in to my droplets, I get permission denied/wrong password?

You might find that SSH keys are not correctly configured, make sure that you have a valid keypair in ~/.ssh/id_rsa and a public key in ~/.ssh/id_rsa.pub. You will also need ~/.axiom/configs/authorized_keys to contain your SSH public key.

## Press enter, do not set a password unless you want to be prompted for every connection.
ssh-keygen

## Copy your SSH pubkey into the authorized_keys file
cat ~/.ssh/id_rsa.pub > ~/.axiom/configs/authorized_keys

## Build a new axiom image (this will bake in your keys) 
axiom-build