users.yml.example

# ShipNode User Configuration
# Define users to provision on your server
# Run: shipnode user sync

users:
  # User with password authentication (must change on first login)
  - username: alice
    email: alice@example.com
    password: "$6$rounds=5000$saltsalt$hashedpassword..."  # Generate with: shipnode mkpasswd

  # User with SSH key + sudo access
  - username: bob
    email: bob@example.com
    authorized_key: "ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIExample... bob@laptop"
    sudo: true

  # CI/CD user - SSH key from file, no sudo
  - username: ci-deploy
    email: ci@example.com
    authorized_key_file: ~/.ssh/ci_deploy.pub

  # Admin with password + SSH key + sudo
  - username: devops
    email: devops@example.com
    password: "$6$rounds=5000$..."  # Generate with: shipnode mkpasswd
    sudo: true
    authorized_key: "ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIExample... devops@work"

  # User with multiple SSH keys
  - username: developer
    email: dev@example.com
    sudo: false
    authorized_keys:
      - "ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIExample1... dev@work"
      - "ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIExample2... dev@home"

# Field descriptions:
# - username:          System username (alphanumeric + underscore/dash, max 32 chars)
# - email:             User email address (required)
# - password:          Hashed password (use 'shipnode mkpasswd' to generate)
# - sudo:              Grant sudo access (true/false, default: false)
# - authorized_key:    Single SSH public key (inline)
# - authorized_key_file: Path to SSH public key file
# - authorized_keys:   Multiple SSH public keys (list)

# Quick start:
# 1. Generate password hash: shipnode mkpasswd
# 2. Copy this file: cp users.yml.example users.yml
# 3. Edit users.yml with your users
# 4. Sync to server: shipnode user sync
# 5. List users: shipnode user list