---
name: "alr-init"
section: "1"
platform: "linux"
package: "alire"
version: "1.2.1-2.1+b1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/alr-init"
---

# alr-init(1)

Creates a new working release with alire metadata, or generate metadata

## NAME

alr-init - Creates a new working release with alire metadata, or generate metadata

## SYNOPSIS

*alr init* \[options\] {--bin\|--lib} \<crate name\>

## OPTIONS

- \--bin

  New project is an executable

- \--lib

  New project is a library

- \--in-place

  Create alr files in current folder

- \--no-skel

  Do not generate non-alire skeleton files

## GLOBAL OPTIONS

- \-c, --config=*ARG*

  Override configuration folder location

- \-f, --force

  Keep going after a recoverable troublesome situation

- \-h, --help

  Display general or command-specific help

- \-n, --non-interactive

  Assume default answers for all user prompts

- \--no-color

  Disables colors in output

- \--no-tty

  Disables control characters in output

- \--prefer-oldest

  Prefer oldest versions instead of newest when resolving dependencies

- \--version

  Displays version and exits

- \-q

  Limit output to errors

- \-v

  Be more verbose (use twice for extra detail)

- \-d, --debug\[\]

  Enable debug-specific log messages

## DESCRIPTION

Initializes a new crate containing a ready-to-build GNAT project. The crate is created as a child of the current directory, containing minimal sources for an executable or library, as specified.

*--in*-place is intended to be used inside the crate directory.

## SEE ALSO

*[alr(1)](/alr/1.md)*, *[alr-get(1)](/alr-get/1.md)*, *[alr-index(1)](/alr-index/1.md)*, *[alr-pin(1)](/alr-pin/1.md)*, *[alr-search(1)](/alr-search/1.md)*, *[alr-show(1)](/alr-show/1.md)*, *[alr-update(1)](/alr-update/1.md)*, *[alr-with(1)](/alr-with/1.md)*, *[gprbuild(1)](/gprbuild/1.md)*

## AUTHOR

Generated with generate-man from Alire execution