Getting started

This page will guide you through creating your first devid persona and configuring the AWS credentials.

1. Grab devid binary from the latest release and make it executable & available in your $PATH.

2. Create your first persona, wiki.

$ devid new wiki

If it complains about $EDITOR not being allowed, run it again with EDITOR=nano devid new wiki.

3. The new command will create a configuration file for your persona, which you can later edit with devid edit --persona wiki. This is how it looks like by default:

apiversion: v1
aws:
  enabled: false
envs: {}
identity:
  email: required
  name: required
ssh:
  enabled: false
tmux:
  enabled: false

First fill identity.email and identity.name. Then to configure aws, set aws.enable: true.

4. Rehash the profile with devid rehash --persona wiki.

5. Load the persona dedicated shell with devid shell --persona wiki

6. Perform AWS authentication as you prefer (maybe settings credentials in your credentials file?). The credentials file for this persona is located at ~/.local/share/devid/personas/wiki/aws/credentials

7. From now on you can enter/exit this persona's shell to use the configured credentials, no more fiddling with profiles!