Hosting a Plumber API on AWS

[This article was first published on R on datawookie, and kindly contributed to R-bloggers]. (You can report issue about the content on this page here)
Want to share your content on R-bloggers? click here if you have a blog, or here if you don't.

I’ve been putting together a small proof-of-concept API using R and plumber. It works flawlessly on my local machine and I was planning on deploying it on an EC2 instance to demo it for a client. However, I ran into a snag: despite opening the required port in my Security Group I was not able to access the API. This is what I needed to do to get it working.

This Didn’t Work

I spun up an EC2 instance and applied a very liberal Security Group: access allowed on all ports from any location. Disaster from a security perspective, but flexible enough to just to get things working.

I installed R and all of the required dependencies and the started the API.

> library(plumber)
> r <- plumb("api.R")
> r$run(port = 8000)

Everything looking good so far.

I tested the API locally on the EC2 instance using curl and it worked as expected. Awesome! I felt like I was on the finishing straight.

Next I tried to access it using the browser from my local machine.

Not good. I checked to see if I could access it using telnet.

$ telnet 8000
telnet: Unable to connect to remote host: Connection refused

Same story. Time to do some research.


A combination of Google and StackOverflow (as usual) came to the rescue.

First I checked for any firewall rules that might be blocking the port.

$ sudo iptables -L
Chain INPUT (policy ACCEPT)
target     prot opt source               destination         

Chain FORWARD (policy DROP)
target     prot opt source               destination         

Chain OUTPUT (policy ACCEPT)
target     prot opt source               destination   

Nothing untoward there. Next I checked what ports were being listened on.

$ netstat -an | grep 8000
tcp        0      0*               LISTEN     

Aha! So something is listening on port 8000 but only on the loopback interface. That’s probably the problem.

Fixing It

I had to rummage through the plumber source on GitHub to find this, but it turns out that you can specify a host parameter as well.

> library(plumber)
> r <- plumb("api.R")
> r$run(host = "", port = 8000)

Let’s check those ports again.

ubuntu@ip-172-31-59-224:~$ netstat -an | grep 8000
tcp        0      0  *               LISTEN      

The API should now be visible outside of localhost.


This small change made all the difference. The API now works perfectly from the EC2 instance.

Note to self (again!): what works locally might very well not work when deployed.

To leave a comment for the author, please follow the link and comment on their blog: R on datawookie. offers daily e-mail updates about R news and tutorials about learning R and many other topics. Click here if you're looking to post or find an R/data-science job.
Want to share your content on R-bloggers? click here if you have a blog, or here if you don't.

Never miss an update!
Subscribe to R-bloggers to receive
e-mails with the latest R posts.
(You will not see this message again.)

Click here to close (This popup will not appear again)