In this post I want to share how to upload an image to AWS S3, the wonderful cloud file hosting solution provided by Amazon Web Services.

I already wrote about this topic in the past in how to upload files to S3 from Node.js

First, install the aws-sdk library:

npm install aws-sdk

Import it at the top of the file where you’ll add the S3 upload functionality:

import AWS from 'aws-sdk'

Next, use the SDK to create an instance of the S3 object. I assign it to a s3 variable:

const s3 = new AWS.S3({
  accessKeyId: process.env.AWS_S3_ACCESS_KEY_ID,
  secretAccessKey: process.env.AWS_S3_SECRET_ACCESS_KEY,
})

Note that I use two environment variables here: AWS_S3_ACCESS_KEY_ID and AWS_S3_SECRET_ACCESS_KEY.

Now comes some “administrative work”. You need to create an IAM profile on AWS (the credentials) with programmatic access with the permissions for AWSCloudFormationFullAccess and AmazonS3FullAccess and an S3 bucket that this user has access to.

I won’t cover this aspect here as you can find tons of articles and documentation about this. I’ll just talk about the JavaScript code you need.

Now, you need an image blob to upload.

You can use a URL like this:

const imageURL = 'https://url-to-image.jpg'
const res = await fetch(imageURL)
const blob = await res.buffer()

or you can get an image sent from a form image field upload in a multipart form:

const imagePath = req.files[0].path
const blob = fs.readFileSync(imagePath)

Finally, call s3.upload() and chain .promise() so you can use await to get the uploaded file object:

const uploadedImage = await s3.upload({
  Bucket: process.env.AWS_S3_BUCKET_NAME,
  Key: req.files[0].originalFilename,
  Body: blob,
}).promise()

AWS_S3_BUCKET_NAME is the name of the S3 bucket, another environment variable

Finally, you can get the URL of the uploaded image on S3 by referencing the Location property:

uploadedImage.Location

You have to make sure you set the S3 bucket as public so you can access that image URL.

Lessons in this unit:

0:	Introduction
1:	Axios crashes the Node.js process when the request fails
2:	How to set up a cron job that runs a Node.js app
3:	How to get both parsed body and raw body in Express
4:	Interact with the Google Analytics API using Node.js
5:	How to bulk convert file names using Node.js
6:	How to deep copy JavaScript objects using structuredClone
7:	How to handle file uploads in Node.js
8:	How to send an email using nodemailer
9:	Logging all the requests coming through an Express app
10:	▶︎ How to upload an image to S3 using Node.js
11:	How to read a CSV file with Node.js
12:	How to set the current working directory of a Node.js program
13:	How to upload files to S3 from Node.js
14:	How to write a CSV file with Node.js
15:	Where to host a Node.js app
16:	Parsing JSON with Node.js
17:	nodemailer, how to embed an image into an email
18:	The Pug Guide
19:	Restarting a Node process without file changes
20:	How to use Sequelize to interact with PostgreSQL