Your submission was sent successfully! Close

You have successfully unsubscribed! Close

Thank you for signing up for our newsletter!
In these regular emails you will find the latest updates about Ubuntu and upcoming events where you can meet our team.Close

Snap environment variables

Environment variables are widely used across Linux to provide convenient access to system and application properties. Both snapcraft and snapd consume, set, and pass-through specific environment variables to support building and running snaps.

All the following examples are assuming the snap hello-world revision 27.

Snap makes available certain environment variables to identify the snap at run-time.


The most important environmental variable is $SNAP. It contains the path to the directory where the snap is mounted. This is where all the installed files in our snap are visible in the filesystem. Remember, an installed snap is read-only and cannot be changed.

This variable is typically pointing to the host location:


Which is the snap revision specific installation path. It also corresponds to:


The typical use cases of this variable are:

  • Locate a file relatively to the snap (an executable, a library, configuration file)
  • Extend the $LD_LIBRARY_PATH to a new location inside our snap.

This variable is available with snapd and snapcraft.


The $SNAP_INSTANCE_NAME variable is less common.

This variable is going to contain the exact name of the snap. In the case of snap parallel installs a snap could be installed under a different name. We could even have multiple times the same snap installed. By leveraging the $SNAP_INSTANCE_NAME we can make sure that we refer to our snap instance and not another one.

The typical use cases of this variable are:

  • Restart a daemon application from a hook: snapctl restart $SNAP_INSTANCE_NAME.MY_APP
  • Make sure there are no confusion between parallel installs

The snap documentation for environment variables describe many more features that could be useful in other projects.

This page was last modified 10 months ago. Help improve this document in the forum.