Uploading files in Firebase - Commands & Configuration

Introduction

Uploading files to Firebase Storage lets you save images, documents, or other files in the cloud. This helps your app share and access files easily without using your own server.

When you want users to upload profile pictures to your app.

When your app needs to save documents or reports for later access.

When you want to store images for a gallery that all users can see.

When you want to back up files from a device to the cloud automatically.

When you want to share files between different parts of your app securely.

Config File - firebase.json

firebase.json

{
  "storage": {
    "rules": "storage.rules"
  }
}

This file tells Firebase to use the storage.rules file to control who can upload or download files.

Commands

This command sets up Firebase Storage in your project and creates the necessary configuration files.

Terminal

firebase init storage

Expected Output

=== Storage Setup ===

✔ Firebase Storage: Configure security rules and indexes files for Cloud Storage

✔ storage.rules file has been created.

Firebase initialization complete.

This command uploads your storage rules and configuration to Firebase so your storage is ready to use.

Terminal

firebase deploy --only storage

Expected Output

=== Deploying to 'your-project-id'...

✔  storage: storage.rules



✔  Deploy complete!



Project Console: https://console.firebase.google.com/project/your-project-id/overview

→

--only storage - Deploys only the storage part without affecting other Firebase services.

Uploads the local file 'local-image.jpg' to Firebase Storage under the path 'images/profile.jpg'.

Terminal

firebase storage:upload ./local-image.jpg images/profile.jpg

Expected Output

✔ Uploaded ./local-image.jpg to images/profile.jpg

Lists all files stored under the 'images' folder in Firebase Storage to verify the upload.

Terminal

firebase storage:list images

Expected Output

images/profile.jpg

Key Concept

If you remember nothing else from this pattern, remember: you must initialize Firebase Storage, set rules, deploy them, then upload files to the correct path.

Common Mistakes

Trying to upload files before running 'firebase init storage' and deploying rules.

Firebase Storage won't accept uploads without proper initialization and deployed rules, causing errors.

Always run 'firebase init storage' and 'firebase deploy --only storage' before uploading files.

Uploading files to a wrong or non-existent path.

Files may not be found later or overwrite important data if paths are incorrect.

Use clear folder paths like 'images/profile.jpg' and verify with 'firebase storage:list'.

Summary

Initialize Firebase Storage with 'firebase init storage' to create config files.

Deploy storage rules using 'firebase deploy --only storage' to enable uploads.

Upload files with 'firebase storage:upload' specifying local and cloud paths.

Verify uploads by listing files with 'firebase storage:list' command.