# Snapcraft Packages (snaps) GoReleaser can also generate `snap` packages. [Snaps](http://snapcraft.io/) are a new packaging format, that will let you publish your project directly to the Ubuntu store. From there it will be installable in all the [supported Linux distros](https://snapcraft.io/docs/core/install), with automatic and transactional updates. You can read more about it in the [snapcraft docs](https://snapcraft.io/docs/). Available options: ```yaml # .goreleaser.yaml snapcrafts: - # ID of the snapcraft config, must be unique. # Defaults to "default". id: foo # Build IDs for the builds you want to create snapcraft packages for. # Defaults to all builds. builds: - foo - bar # You can change the name of the package. # Default: `{{ .ProjectName }}_{{ .Version }}_{{ .Os }}_{{ .Arch }}{{ with .Arm }}v{{ . }}{{ end }}{{ with .Mips }}_{{ . }}{{ end }}{{ if not (eq .Amd64 "v1") }}{{ .Amd64 }}{{ end }}` name_template: "{{ .ProjectName }}_{{ .Version }}_{{ .Os }}_{{ .Arch }}" # Replacements for GOOS and GOARCH in the package name. # Keys should be valid GOOSs or GOARCHs. # Values are the respective replacements. # Default is empty. replacements: amd64: 64-bit 386: 32-bit darwin: macOS linux: Tux # The name of the snap. This is optional. # Default is project name. name: drumroll # Whether to publish the snap to the snapcraft store. # Remember you need to `snapcraft login` first. # Defaults to false. publish: true # Single-line elevator pitch for your amazing snap. # 79 char long at most. summary: Software to create fast and easy drum rolls. # This the description of your snap. You have a paragraph or two to tell the # most important story about your snap. Keep it under 100 words though, # we live in tweetspace and your description wants to look good in the snap # store. description: This is the best drum roll application out there. Install it and awe! # Channels in store where snap will be pushed. # Default depends on grade: # * `stable` = ["edge", "beta", "candidate", "stable"] # * `devel` = ["edge", "beta"] # More info about channels here: # https://snapcraft.io/docs/reference/channels channel_templates: - edge - beta - candidate - stable - {{ .Major }}.{{ .Minor }}/edge - {{ .Major }}.{{ .Minor }}/beta - {{ .Major }}.{{ .Minor }}/candidate - {{ .Major }}.{{ .Minor }}/stable # A guardrail to prevent you from releasing a snap to all your users before # it is ready. # `devel` will let you release only to the `edge` and `beta` channels in the # store. `stable` will let you release also to the `candidate` and `stable` # channels. grade: stable # Snaps can be setup to follow three different confinement policies: # `strict`, `devmode` and `classic`. A strict confinement where the snap # can only read and write in its own namespace is recommended. Extra # permissions for strict snaps can be declared as `plugs` for the app, which # are explained later. More info about confinement here: # https://snapcraft.io/docs/reference/confinement confinement: strict # Your app's license, based on SPDX license expressions: https://spdx.org/licenses # Default is empty. license: MIT # A snap of type base to be used as the execution environment for this snap. # Valid values are: # * bare - Empty base snap; # * core - Ubuntu Core 16; # * core18 - Ubuntu Core 18. # Default is empty. base: core18 # Add extra files on the resulting snap. Useful for including wrapper # scripts or other useful static files. Source filenames are relative to the # project directory. Destination filenames are relative to the snap prime # directory. # Default is empty. extra_files: - source: drumroll.wrapper destination: bin/drumroll.wrapper mode: 0755 # With layouts, you can make elements in $SNAP, $SNAP_DATA, $SNAP_COMMON # accessible from locations such as /usr, /var and /etc. This helps when using # pre-compiled binaries and libraries that expect to find files and # directories outside of locations referenced by $SNAP or $SNAP_DATA. # About snap environment variables: # * HOME: set to SNAP_USER_DATA for all commands # * SNAP: read-only install directory # * SNAP_ARCH: the architecture of device (eg, amd64, arm64, armhf, i386, etc) # * SNAP_DATA: writable area for a particular revision of the snap # * SNAP_COMMON: writable area common across all revisions of the snap # * SNAP_LIBRARY_PATH: additional directories which should be added to LD_LIBRARY_PATH # * SNAP_NAME: snap name # * SNAP_INSTANCE_NAME: snap instance name incl. instance key if one is set (snapd 2.36+) # * SNAP_INSTANCE_KEY: instance key if any (snapd 2.36+) # * SNAP_REVISION: store revision of the snap # * SNAP_USER_DATA: per-user writable area for a particular revision of the snap # * SNAP_USER_COMMON: per-user writable area common across all revisions of the snap # * SNAP_VERSION: snap version (from snap.yaml) # More info about layout here: # https://snapcraft.io/docs/snap-layouts # Default is empty. layout: # The path you want to access in sandbox. /etc/drumroll: # Which outside file or directory you want to map to sandbox. # Valid keys are: # * bind - Bind-mount a directory. # * bind_file - Bind-mount a file. # * symlink - Create a symbolic link. # * type - Mount a private temporary in-memory filesystem. bind: $SNAP_DATA/etc # Each binary built by GoReleaser is an app inside the snap. In this section # you can declare extra details for those binaries. It is optional. # See: https://snapcraft.io/docs/snapcraft-app-and-service-metadata apps: # The name of the app must be the same name as the binary built or the snapcraft name. drumroll: # If you any to pass args to your binary, you can add them with the # args option. args: --foo # The kind of wrapper to generate for the given command. # Defaults to empty. adapter: none # List of applications that are ordered to be started after the current # one. # Defaults to empty. after: ["postdrum"] # Aliases for the app command. # Defaults to empty. # https://snapcraft.io/docs/commands-and-aliases#heading--aliases aliases: ["droll"] # Defines the name of the .desktop file used to start an application # with the desktop session. # Defaults to empty. # https://snapcraft.io/docs/snap-format#heading--autostart autostart: drumroll.desktop # List of applications that are ordered to be started before the current # one. # Defaults to empty. before: ["predrum"] # D-Bus name this service is reachable as. Mandatory if daemon=dbus. # Defaults to empty. bus_name: drumbus # A list of commands to be executed in order before the command of this # app. # Defaults to empty. command_chain: ["foo", "bar", "baz"] # An identifier to a desktop-id within an external appstream file. # https://snapcraft.io/docs/using-external-metadata common_id: "com.example.drumroll" # Bash completion snippet. More information about completion here: # Defaults to empty. # https://docs.snapcraft.io/tab-completion-for-snaps. completer: drumroll-completion.bash # You can override the command name. # Default is the app name. command: bin/drumroll.wrapper # If you want your app to be autostarted and to always run in the # background, you can make it a simple daemon. # Defaults to empty. daemon: simple # Location of the .desktop file. # Defaults to empty. desktop: usr/share/applications/drumroll.desktop # A set of key-value pairs specifying environment variables. # Defaults to empty. environment: foo: bar baz: quo # A list of Snapcraft extensions this app depends on. # Defaults to empty. # https://snapcraft.io/docs/snapcraft-extensions extensions: ["gnome-3-38"] # Defines whether a freshly installed daemon is started automatically, # or whether startup control is deferred to the snap. # Defaults to empty. Requires `daemon` to be set. install_mode: "disable" # A set of key-value attributes passed through to snap.yaml without # snapcraft validation. # Defaults to empty. # https://snapcraft.io/docs/using-in-development-features passthrough: foo: bar # If your app requires extra permissions to work outside of its default # confined space, declare them here. # You can read the documentation about the available plugs and the # things they allow: # https://snapcraft.io/docs/reference/interfaces. plugs: ["home", "network", "personal-files"] # Sets a command to run from inside the snap after a service stops. # Defaults to empty. post_stop_command: foo # Controls whether the daemon should be restarted during a snap refresh. # Defaults to empty. refresh_mode: endure # Command to use to ask the service to reload its configuration. # Defaults to empty. Requires `daemon` to be set. reload_command: foo # Restart condition of the snap. # Defaults to empty. # https://snapcraft.io/docs/snapcraft-yaml-reference restart_condition: "always" # List of slots for interfaces to connect to. # Defaults to empty. slots: ["foo", "bar", "baz"] # Maps a daemon’s sockets to services and activates them. # Defaults to empty. Requires `plugs` to contain `network-bind`. sockets: sock: listen-stream: $SNAP_COMMON/socket socket-group: socket-group socket-mode: 416 # Time to wait for daemon to start. # Defaults to empty. start_timeout: 42ms # Command to use to stop the service. # Defaults to empty. Requires `daemon` to be set. stop_command: foo # Controls how the daemon should be stopped. # Defaults to empty. Requires `daemon` to be set. stop_mode: sigterm # Time to wait for daemon to stop. # Defaults to empty. stop_timeout: 42ms # Schedules when, or how often, to run a service or command. # Defaults to empty. Requires `daemon` to be set. # https://snapcraft.io/docs/services-and-daemons timer: "00:00-24:00/24" # Declares the service watchdog timeout. # Defaults to empty. Requires `plugs` to contain `daemon-notify`. watchdog_timeout: 42ms # Allows plugs to be configured. Plugs like system-files and personal-files # require this. # Default is empty. plugs: personal-files: read: - $HOME/.foo write: - $HOME/.foo - $HOME/.foobar ``` !!! tip Learn more about the [name template engine](/customization/templates/). !!! note GoReleaser will not install `snapcraft` nor any of its dependencies for you.