-
Notifications
You must be signed in to change notification settings - Fork 6
0 Installation
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)
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
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.
- 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)
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 rundoctl 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
? Runaxiom-account-setup
.axiom/interact/axiom-ls: line 5: /home/pry/.axiom/interact/includes/functions.sh: No such file or directory
Run axiom-account to see what account profiles you have
axiom-account
Then run axiom-account <profile>
axiom-account personal
$ 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
rm ~/.axiom/interact/includes/functions.sh
axiom-account <profile>
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