Managing files on Bitrise

Managing files on Bitrise allows you to upload files to use in your builds. You are required to upload files for the purposes of code signing. Builds also produce files as outputs. The good news is that this is all very simple!

Uploading files to use in your build

If your build requires any files to make it work, upload them to the Generic File Storage. The Generic File Storage accepts any file type, all you need to do is provide a unique ID and upload the file.

Restrictions on uploading a file to the Generic File Storage

  • The file cannot be bigger than 5 MB.
  • you can only store a total of 5 different files at the same time. If you want to upload more, you need to delete one of the files in the storage.
  1. Go to the Dashboard.
  2. Open the app you want to add files to.
  3. Open the Workflow Editor.
  4. Click the Code Signing tab.

    Managing files on Bitrise

  5. Scroll down to the Generic File Storage and provide a unique ID to your file.

    The unique ID will be part of the generated download URL that Bitrise stores as an Environment Variable.

  6. Upload the file by clicking Upload file.

    Remember that the file size cannot exceed 5 MB.

Now you can use this file in a variety of ways in your build - read more in the detailed guide about the Generic File Storage.

Once a file is uploaded, it can also be:

Code signing files

Bitrise can do your code signing for you but we need some files to make it happen.

For Android apps, upload code signing files to the Generic File Storage.

For iOS files, you need to use the dedicated menu options for provisioning profiles and code signing identities.

Read more about Android and iOS code signing in our detailed guides.

Password protection for iOS code signing files

You can set a password in Xcode to store your code signing certificates securely. This password can be viewed on Bitrise: click on the eye icon next to the certificate file, in the Password field.

Output files

Builds can generate and export files: for example, you can export a binary package file of your app with a Bitrise build. You can easily find these files:

  1. Open the build that you ran.
  2. Go to the Apps & Artifacts tab.
  3. View and download the generated files.

You can read more about build artifacts in our detailed guide!

Using encrypted files

You can use encrypted files on Bitrise, easily and securely. All you need to do is encrypt the file on your computer, upload it to your repo and use a Step to decrypt it when you need it.

In this example, we’ll show how to do this. We use the pwgen password generator tool and GPG as the encryption software.


Please note that the Decrypt file Step only decrypts files encrypted with GPG. If you use other encryption software, you will not be able to decrypt files on Bitrise.

  1. Open your Terminal/Command Line.
  2. Create a 32 character passphrase for encryption.

    pwgen -s 32 1
  3. Encrypt your file.

    gpg -c my_secret_file

    Optionally, you can encrypt your file(s) in a non-interactive way.

    gpg --batch --passphrase <passphrase> -c my_secret_file
  4. Upload my_secret_file to the Generic File Storage on Bitrise.
  5. Add the Decrypt file Step to your workflow.
  6. Add your passphrase as a secret Environment Variable and insert it to the relevant Step input.
  7. Add the encrypted file path and the output file path to the relevant Step inputs.

    You can find the Environment Variable for the encrypted file path in the Generic File Storage.

That’s it! Once you run the build, the Step will decrypt your file and you can use it for whatever you need it for!