Classic Docs
Docs Navigation

Adding configuration files

Some projects during CI need files that cannot be part of the code repository. Examples include configuration files that contain sensitive data, YAML files that you need only on Semaphore and so on. You can easily manage such files on Semaphore using the "Configuration Files", which will make them available during the build and deploy process.

# Adding a new configuration file

To get started, open your project settings, "Configuration Files" tab. Click to add a new file.

For a new file you need to specify a target file path. For instance, if you have a project "semaphore" and you want to add a new file s3.yml to your project's config directory, your file path should look like this semaphore/config/s3.yml.

Content of the configuration file can be entered in the text area below the file path.

# Encrypting content of configuration files

For greater security, the content of your files can be stored as encrypted. We strongly recommend that you select this option if you are adding sensitive data such as SSH keys. Once created, encrypted file cannot be edited. The identity of your file can be determined by the MD5 hash.

# Adding a configuration file from a secret

In order to share the common build configuration, you can add a configuration file from a secret that you've previously created. Secrets are more convenient solution if you have projects that share some configuration files (e.g. ~/.aws/credentials). Learn more about secrets and adding a configuration file to a secret.

See also: how to add another SSH key to your build.

Semaphore Docs are open source — Edit on GitHub


Occasional lightweight product and blog updates. Unsubscribe at any time.

2009-2019 © Rendered Text. All rights reserved. Terms of Service, Privacy policy, Security.