alpacon server create

Register a new server by selecting a registration method and generating an installation guide. The command walks you through choosing a registration method, a target platform, and a registration token, then prints the exact commands to run on your server.

alpacon server create [flags]

Registration methods

  • token-install (default): the guide includes the Alpamon register command to run on your server.
  • ansible: the guide produces an ansible-playbook command using the alpacax.alpacon collection, so you can register one or many servers from a control node.

Supported platforms: debian, rhel, darwin, windows.

Options

  -h, --help               help for create
      --json               output the installation guide as structured JSON instead of markdown
  -m, --method string      registration method: token-install, ansible (default "token-install")
  -n, --name string        server name (optional; hostname used if not set)
      --new-token string   create a new registration token with this name
  -p, --platform string    target OS platform: debian, rhel, darwin, windows
  -t, --token string       existing registration token name

Non-interactive mode

When --platform and either --token or --new-token are provided, the command runs non-interactively. This is useful for scripts and automation pipelines. Use --token to reference an existing registration token by name, or --new-token to create a new one on the fly. See Registration token management for managing tokens.

Examples

Generate an installation guide interactively:

alpacon server create

Generate a guide for a Debian server with an existing token:

alpacon server create --platform debian --token prod-token

Set the server name explicitly (hostname is used if not set):

alpacon server create --platform rhel --token prod-token --name my-server

Generate a guide for a macOS server:

alpacon server create --platform darwin --token prod-token

Generate an Ansible playbook command instead of a token-install guide:

alpacon server create --method ansible --platform debian --token prod-token

Output the guide as structured JSON:

alpacon server create -m ansible -p windows -t prod-token --json
Last updated: