We hope you find this tutorial helpful. In addition to guides like this one, we provide simple cloud infrastructure for developers. Learn more →

How To Deploy a Node.js and MongoDB Application with Rancher on Ubuntu 16.04

PostedJanuary 5, 2017 14.4k views Docker Load Balancing Scaling Configuration Management Node.js MongoDB Ubuntu 16.04


Rancher is an open source, self-hosted, and complete platform to run and easily manage containers in production. Being a Docker image itself, a Rancher server will work on any Linux host where Docker is available.

Some of the key features that make Rancher an attractive solution are:

  • Cross-host networking: All the servers added to Rancher are linked allowing secure communication between containers.
  • Load balancing: A load balancing service is included to distribute workloads between containers or even across multiple clouds.
  • Service discovery: Rancher includes an internal DNS system enabling containers and services to be identified by name so they can be used within other services on the network.
  • Infrastructure management: With Rancher you can add, monitor, and manage computing resources from any cloud provider.
  • Orchestration engines: Rancher is the only container management platform that supports the most popular container orchestration frameworks including Cattle, Swarm, Kubernetes, and Mesos. So if you already have your infrastructure working with one of those frameworks then you will be able to use Rancher with ease.
  • Open Source: Rancher is free, open, and transparent. You have absolute control of your infrastructure.

In this guide, you will build a Rancher cluster to deploy a load-balanced Node.js application, with support for data storage using MongoDB.

At the end of this tutorial, you'll have four load-balanced instances of a simple Node.js application and a MongoDB server with a separate data container for persistent storage.


  • One 1GB Ubuntu 16.04 Droplet with Rancher installed. We'll use Rancher to create six additional Droplets, each with 1GB of RAM. Follow Steps 1 and 2 of How To Manage Your Multi-Node Deployments with Rancher and Docker Machine on Ubuntu 16.04 to set up your initial Droplet with Rancher.
  • A Node.js application that uses MongoDB for data storage. This tutorial provides a simple example using the Hapi.js library you can use in case you don’t have your own application ready yet. You can find this example application in this Github repository, and we'll explore it in detail in Step 1.
  • Git installed on your local machine, so you can clone the example application. Follow the official Git installation documentation if you need to fulfill this prerequisite.
  • Docker installed on your local machine, so you can build the application image we'll deploy. You can follow the official documentation for this.
  • An account on Docker Hub, which is a free and public registry for Docker images. This is where we are going to host our application code so we can deploy it to multiple hosts using Rancher. You will need your Docker Hub username to complete the steps in this tutorial.
  • A DigitalOcean Access Token with both Read and Write access, which you can generate by visiting the Applications & API page. Copy this token, as you will need to enter it in Rancher to create additional hosts.

You should also have basic knowledge of Docker concepts like containers, images, and Dockerfiles. See How To Install and Use Docker on Ubuntu 16.04 for more about using Docker.

Step 1 — Exploring the Node.js Application

For this tutorial, we'll use a simple Node.js application based on the Hapi.js framework that receives a message, records it, and lists all the messages previously submitted. Let's explore how the application works and how it receives configuration values so we can set those values with Docker when we create our image.

You'll prepare the application and the Docker image on your local development machine, rather than a server.

Clone the example application to your local machine using the following command:

  • git clone https://github.com/do-community/hapi-example

Then navigate into the project directory:

  • cd hapi-example

Let's look at the main file of the application, server.js. It contains the MongoDB connection and the code to initialize the server. Open this file in your local text editor and you'll see the following contents:

const Hapi = require('hapi');
const mongojs = require('mongojs');

// Loads environment variables
// Used only in development
require('dotenv').config({silent: true});

const server = new Hapi.Server();
server.connection({ port: process.env.PORT || 3000 });

// Connect with the database
server.app.db = mongojs(process.env.MONGO_HOST + '/api');

// Add the routes
server.register(require('./routes'), (err) => {

  if (err) {
    console.error('Failed to load plugin:', err);

  // Start the server
  server.start((err) => {
    if (err) {
      throw err;

    console.log('Server running at:', server.info.uri);

The code for the routes is encapsulated as a Hapi.js plugin to save space in this tutorial, but if you're curious, you can look in the file routes.js.

The critical parts of the server.js file are as follows:

require('dotenv').config({silent: true});

This uses the dotenv Node.js package to load our environment variables from a .env file. You can review the documentation for the dotenv package in its Github repository if you're interested in how it works. We save the variables in this file only for the development process; it’s easier than manually writing the variables in the terminal. In production, we are going to get the variables from Docker, via Rancher.

Next we set the port for the server, using an environment variable called PORT, with a fallback value of 3000, in case the variable isn’t defined:

server.connection({ port: process.env.PORT || 3000 });

Port 3000 is a common convention for Node.js applications. This value can be changed if necessary; the only requirement is that it should be above 1023 and below 65535.

Finally, before loading the routes and starting the server, we connect to the MongoDB server, using an environment variable called MONGO_HOST:

server.app.db = mongojs(process.env.MONGO_HOST + '/api');

This environment value will be defined through Rancher with the host name of the MongoDB server once we create the MongoDB containers. The value api is the name of the database we are going to connect to, and it will be set up automatically if it doesn't exist.

Now that you have some background on what the app is looking for, and how we configure its port and database connection, let's bring Docker into the picture.

Step 2 — Building the Docker Image

Rancher uses Docker images to deploy applications to servers, so let's create a Docker image for our application. In order to build a Docker image for our app, we need a file called Dockerfile which contains a series of steps that Docker will follow when building the image. This file is already included in the application repository that you cloned. Let's look at its contents to understand how it works. Open it in your text editor and you'll see the following code:

FROM node:6
MAINTAINER James Kolce <contact@jameskolce.com>

RUN mkdir -p /usr/api
COPY . /usr/api
WORKDIR /usr/api
RUN npm install --production


CMD ["npm", "start"]

Let's look at each step in detail. First, we see this line:

FROM node:6

This line declares that our image is built on top of the official Node.js image from Docker Hub, and we are selecting version 6 of Node.js since our app makes use of some ES6 features only available in that version or higher. It's recommended practice to choose a particular version instead of just using latest in production so you avoid any changes that may break your app.

After that line, we set up our working directory:

RUN mkdir -p /usr/api
COPY . /usr/api
WORKDIR /usr/api

First we run the mkdir command to create a new directory called /usr/api, which is where our application will live. The -p flag means that mkdir will create intermediate directories as required. Then we copy the contents of the image to that directory. Then we set this new directory as our working directory so subsequent commands will be run from that directory.

The next line runs the npm command and installs the production dependencies for our app.

RUN npm install --production

Next, we see these two lines:


The first line defines an environment variable called PORT which our application will use for its listening port. Just in case this variable isn't defined, we set 3000 as the default value. Then we expose that port so we can have access to it from outside of the container. Using an environment variable makes this easier to change without having to rewrite our application code. And remember, our application is designed to use these environment variables.

The last step in our Dockerfile runs our Node.js server by issuing the npm start command:

CMD ["npm", "start"]

To create the Docker image of our application from this file, ensure you are in the hapi-example folder in your terminal and execute the following command:

  • docker build -t your_dockerhub_username/hapi-example .

This command creates a Docker image using our Dockerfile. Note the dot at the end of the command. This specifies the path to the Dockerfile, which is in the current folder. The -t flag sets a tag for our image, and we'll use your_dockerhub_username/hapi-example for the tag, which is a label we apply to the image so we can use it to create container instances from the image. We use the Docker Hub username as a prefix, as we are preparing to publish this image once we test it, and the local tag of the Docker image must match the repository name on Docker Hub.

Note: If you receive the message Cannot connect to the Docker daemon. Is the docker daemon running on this host? when you run this command, ensure the Docker app is running and that Docker is started. Then run the command again.

Now let's test the image we just built so we can be sure that everything is working as expected. As you saw earlier, our application relies on MongoDB, so let's create a MongoDB container our app can use to store its data. Run the following command to create and start a MongoDB container based on the official MongoDB Docker image:

  • docker run --name testdb -p 27017:27017 -d mongo:3

We assign a temporary name to the container with the --name option; we will use that name to stop the server when we finish testing the application. We also bind the host port 27017 to the port exposed by the container so we can test that MongoDB is running by using our local web browser. Finally, we specify the image we want to use. It's a good idea to use the same version of MongoDB that the application was developed with to assure that everything works as expected, so in this case we specify version 3.

After executing that command, visit http://localhost:27017 in your browser and you'll see the message: It looks like you are trying to access MongoDB over HTTP on the native driver port which means that MongoDB is running.

Now run your application container and link it to the MongoDB container by running this command:

  • docker run --name hapi-app -p 3000:3000 -d -e MONGO_HOST=testdb --link testdb your_dockerhub_username/hapi-example

This command is similar to the command we used to start the MongoDB container, but this time we use our application image (your_dockerhub_username/hapi-example) and map port 3000 of our host with the port exposed by the container. This is the same port we used when we created the Dockerfile. Also, we add an environment variable called MONGO_HOST that specifies the name of our MongoDB container which will be used by our application to connect to the database server. The --link testdb parameter lets us use the name of the database container as a host inside of our application's container.

After running the command, test the application by visiting http://localhost:3000 in your browser. It should show an empty page without any errors.

Note: You might also see an empty array ([ ]) or the JSON view on Firefox when you visit http://localhost:3000. Either of these outcomes is okay.

Now that we've proven the Docker image works locally, let's stop and delete our local containers. Keep in mind that deleting a container is not the same as deleting an image. Our image is going to remain intact so we can recreate the container later, or push the image to Rancher, which is what we'll do after we clean up our local environment.

First, stop the database container by using its name you defined previously:

  • docker stop testdb

Now that the container is stopped, you can delete it from your machine since you won't need it anymore:

  • docker rm testdb

Repeat the same steps for your application container. First stop it, then remove it.

  • docker stop hapi-app && docker rm hapi-app

Now let's publish the working image so we can use it with Rancher.

Step 3 — Uploading the Image to Docker Hub

To deploy containers using Rancher we need access to a Docker registry, where we can create a repository to store our Docker image. We'll use Docker Hub which is the official registry for Docker. Docker Hub is free to use for public repositories.

Log in to Docker Hub with your username and password. Once logged in, click the Create Repository button at the right side of the screen. Fill in the fields as follows:

  • Name (required): The name of your repository, in this case, it's hapi-example.
  • Description: A short description to identify your image quickly in the future.
  • Full Description: You can add a markdown document here as a reference for your image but since our application is pretty simple you can leave this field empty.
  • Visibility: You can set your images as private where only you will have access to it, or as public where everybody can use your image. For this tutorial, create a public repository.

Note: If you set your repository as private, you will have to add your Docker Hub credentials in the Infrastructure -> Registries page in the Rancher UI.

After all the required fields are filled in, click the Create button. When the process is done you will be redirected to your new repository site.

In order to upload your Docker image, you must log in to Docker Hub through the docker command. Back in your terminal, execute the following command:

  • docker login

You'll be prompted to enter your username and password. Like most CLI tools, you won't see your password as you type it.

Once you're logged in, upload the image to Docker Hub with the following command which uploads all the files to the repository:

  • docker push your_dockerhub_username/hapi-example

Pushing an image may take several minutes depending on your local internet connection. Once the image is successfully published, we can set up our hosts using Rancher.

Step 4 — Creating and Labeling the Host Servers in Rancher

Let's use Rancher to create all of the hosts we'll need to deploy our services. We'll need two for the Node.js application, one for the MongoDB server, and one for the load balancer. We'll do all of this within the Rancher UI using DigitalOcean's API.

Visit your Rancher interface in your browser by visiting http://your_rancher_ip_address and follow these steps to create the four hosts we'll need:

  1. Go to Infrastructure > Hosts and click the Add Host button at the top of the page.
  2. Select DigitalOcean as the host provider.
  3. Paste your DigitalOcean Application Token that you generated into the Access Token field and click Next: Configure Droplet.
  4. Assign a name. Enter host, which will automatically generate names from host1 to host4.
  5. Move the Quantity slider to 4 hosts.
  6. For Image, use the default value of Ubuntu 16.04.1 x64.
  7. For Size, use the default value of 1gb RAM, 30gb Disk, 1 vCPU.
  8. You can leave the SSH User field as root.
  9. Click the Create button and wait a couple of minutes while the servers are created and added to Rancher.

Once Rancher finishes creating all of the hosts, we'll add a label to each one of them to classify their type so we can organize where we are going to put each of our components. Labeling hosts also lets us scale our servers depending of their type. For example, if we are getting too much demand for our application, we can increase the number of servers of that type and Rancher will automatically deploy the appropriate Docker containers for us. The labels that we are going to create are: loadbalancer, application and database.

Let's create the first label, loadbalancer.

  1. Go to Infrastructure > Hosts and select the first host, host1.
  2. Click the Options button (the icon with three vertical dots on the top of the page) and select the Edit option.
  3. Click the +Add Label button and in the Key input enter the word type, and then enter loadbalancer in the Value input.
  4. Click the Save button.

Note: Your hosts might appear as host1.localdomain; this is a normal behavior, and it can change depending on your environment.

Next, label the application hosts. Repeat the previous process with the next two hosts but this time use application in the Value input.

For the last host, repeat the process again but use database in the Value input.

All four hosts should now have labels, so let's set up the services. We'll start with the database.

Step 5 — Deploying the MongoDB Server

We'll use the official MongoDB Docker image on Docker Hub to deploy our database server. The MongoDB container will also have a sidekick container to store all of our data. Both containers will be deployed on the host labeled as database.

To do that, follow these steps in the Rancher user interface:

  1. Select the Stacks menu, choose the User option, and then click the Define a Service button.
  2. In the Add Service page, ensure the Scale slider is set to Run 1 container.
  3. For the name of the service, use MongoDB.
  4. For the image, enter mongo:3.
  5. Click the Add Sidekick Container button in the top section.
  6. Name this new container Data. This container will be used as a volume to store the MongoDB data.
  7. Since we are going to use this container for data only, use the busybox image.
  8. In the Command tab below, switch the Autorestart option to Never (Start Once), because we will use this container only for storage.
  9. Switch to the Volumes tab and add a new volume by clicking the Add Volume button. Enter /data/db into the text field that appears. This is the default path where MongoDB stores data.
  10. Switch to the Scheduling tab, click the Add Schedule Rule button and enter the following parameters: The Host must have a host label of type = database. Use the dropdowns to help you create this rule.
  11. Click the MongoDB service tab, and then scroll down to the Command tab, and make sure the Autorestart option is set to Always.
  12. Switch to the Volumes tab and select Data in the Volumes From option.
  13. Switch to the Scheduling tab and add a new scheduling rule with the following parameters: The Host must have a host label of type = database
  14. Finally, click the Create button at the bottom and wait for a couple of minutes while the service is activated.

Now let's configure the application service.

Step 6 — Deploying the Node.js Application

We'll use a similar approach to deploy the Node.js application we previously prepared. The image we stored on Docker Hub will be deployed on the hosts labeled application, and will be linked to the MongoDB service to store and access data. So, follow these steps in the Rancher user interface:

  1. Select the Stacks menu, choose the User option, and then click the Add Service button in the Default stack.
  2. In the Scale section, select the option Always run one instance of this container on every host.
  3. The name we are going to use for this service is NodeJS.
  4. For the image we'll use the one we deployed to Docker Hub. Enter your_dockerhub_username/hapi-example.
  5. Click the Service Links button, select Destination Service and choose MongoDB. Then select As name and enter db, so our NodeJS service can have access to the MongoDB service using this name.
  6. In the Command tab on the bottom of the page, click the Add Environment Variable button and add a variable named MONGO_HOST with the value of db, which maps to the destination service name we used in the previous step. Remember that our application relies on this environment variable to locate the database server.
  7. Switch to the Scheduling tab, click the Add Scheduling Rule button and use the dropdowns to construct a rule that says The Host must have a host label of type = application.
  8. Finally, click Create and wait for Rancher to set up the service.

In a short time, you'll see that the new NodeJS service has launched two containers. Select the Infrastructure menu, click on Hosts, and you'll see that both hosts labeled application are now running this new service. Since there's more than one, let's set up a load balancer so we can use both of these hosts effectively.

Step 7 — Deploying the Load Balancer

Our load balancer is going to be linked to our NodeJS services to balance the workload between all the containers across the application hosts.

  1. To create the load balancer, select the Stacks menu and choose the User option. This time click the arrow next to the Add Service button and select Add Load Balancer from the dropdown list.
  2. For the Name, enter LoadBalancer.
  3. In the Port Rules section, set the Request Host Port (the first Port field) to 80, and the Target Port (the second one) to 3000 which is the port our NodeJS containers are exposing.
  4. In the Target Service option select NodeJS, which is the service we recently created.
  5. In the Scheduling tab on the bottom of the page click the Add Scheduling Rule button and create a rule that says The Host must have a host label of type = loadbalancer.
  6. Finally, click Create and wait while Rancher activates the service.

Each time we've created a service, we've used the labels we created to determine how the service gets deployed. This makes managing additional hosts easy in the future. Now let's make sure things work.

Step 8 — Testing the Application

To test our application, we need to get the address of the load balancer host. Select the LoadBalancer service and you'll see the IP address in the Ports tab.

To test that our application is working, execute the following command in a terminal:

curl your_load_balancer_ip

This command sends a GET request to the server. You'll see a response that contains an empty array ([]) because our database is empty.

Execute the following command to add a message to the database and ensure that the application can save data:

curl -i -X POST -H "Content-Type:application/json" your_load_balancer_ip -d '{"message":"This is a test"}'

This command sends a POST request to the server with a JSON object which contains a message key with the value of This is a test. After sending the request, you should receive the same message you sent as a response, along with an _id from MongoDB. This means that the connection with the MongoDB server is working and the application saved your data.

This application will only accept a message key, any other name will be discarded.

Now, to double check that the application functions properly, execute the first command again and you should get the message you added in the previous step.

curl your_load_balancer_ip

The output will look like this:

HTTP/1.1 200 OK
content-type: application/json; charset=utf-8
cache-control: no-cache
content-length: 61
Date: Wed, 05 Jan 2017 20:07:02 GMT
Connection: keep-alive

{"message":"This is a test","_id":"e64d85579aee7d1000b075a2"}

Warning: This example application is insecure; anyone who knows the address and the API can add messages to the system. When you're done with this tutorial, you may want to disable this application by deleting the service in Rancher.

At this point you now have two application servers, a database, and a load balancer configured and ready for use. Let's look at how to scale our services to handle more traffic.

Step 9 — Scaling the Node.js Servers

When your application starts getting a lot of demand and your servers can't handle the load, you can increase the amount of Node.js servers and the load will be distributed automatically between the containers across the application hosts. Follow these steps to scale your application:

  1. Go to the Infrastructure > Hosts page and click the Add Host button.
  2. Add your DigitalOcean Access Token in the field of the same name.
  3. Use host5 as the name for the first new host, since the last host we created was host4. Because we are going to create two new hosts, Rancher will name the next one automatically to host6.
  4. Select the quantity you want; in this case, we will add 2 more hosts.
  5. For Image, use the default value of Ubuntu 16.04.1 x64.
  6. For Size, use the default value of 1gb RAM, 30gb Disk, 1 vCPU.
  7. Click the Add Label button and in the Key input enter type, and then enter application in the Value input.
  8. Click the Create button and wait while the new hosts are activated and added to Rancher.

After the new hosts come online, because they are labeled as application hosts, new instances of the NodeJS application will be configured and deployed automatically, and the load balancer will distribute the workload between four containers across four hosts.


In this tutorial you learned how to prepare, deploy, and scale a functional Node.js application with support for data storage with MongoDB. As you can see, with Rancher and its GUI the process is pretty intuitive, and it's easy to scale a complete application. And thanks to Rancher's scheduling features, when your app hits the big time, you'll be able to handle the load with ease.


  • Well explained article. It helped me to understand a lot on the local/in-house server setup environments (where I need to setup all the hardware/software environment, to have a website up and running on our office residing server commercially). Can any one assist me to solve my problem please.

    I want to deploy a CMS application developed in React, Redux, Mongo DB. I am new so I am wondering how can I setup this. Any guidelines will be helpful. I have following questions in my mind:

    1. What are pros and corn of having *Linux *or *Windows *based server. (also which versions are relevant)
    2. How to setup an SSL on local hosting server. What are options.
    3. What are the security precautions to be made.
    4. An internet line with dedicated IP from ISP can be connected, but do need to have any security hardware in middle in the network?
    5. How to setup/connect a purchased domain name (www.mydomain.com) to an internal hosting server.
    6. How to have multiple IPs to an internal hosting server, so if one server fails or one network fails the other keeps working with the purchased domain name. Also how floating IP helps and how this can be setup.
    7. How to log IP(visitors) access log in hardware level to keep server secure. How Ranchet is helpful and what is the purpose of setting up Ranchet. Is it not right to simply install NodeJS on the machine and run application on it (but as I'm new so I need some guidelines on this please).
    8. Is it simple to start application just like I do in my local development environment and everything will be accessible on the DNS (if setup).
    9. How to setup internal code version control system (using any local version control system and also GitHub), so if one deployment fails or creates any trouble; we can then restore to older code version.
    10. How to setup a mailing server to send and receive emails and also how can we setup different emails on local hosting server.

    11. Any application crash and monitoring tools I need to setup? How Nginx is helpful and any comparison with Ranchet?

    12. What is the purpose of Containers and Dockers? and is it a feature or a service or what exactly it serves. As I'm new so I may ask: Is it ok to go for deployment without Containers and Docker :) Dont' be angry please.

    • Hi @mhannan313,

      Those are very wide topics for several articles, I will check those things out and will let you know.

      • Thanks will be wonderful and interesting to know.

        • Well I have to say that you can find most of that information by doing research on Google, I'll write some simple answers but you can find more even in other DigitalOcean articles.

          1. Depends on the sofware you are trying to deploy. Usually Linux will work for anything, and Ubuntu is the most common distribution.
          2. Take a look at https://letsencrypt.org/
          3. Too wide subject, you can check books about it on the internet.
          4. Not necessarily, you can set up a firewall by software.
          5. Using a DNS server/service.
          6. You can put a load balancer and point your domain to it, the load balancer will be (virtually) connected to the application servers. To use floating ips check: https://www.digitalocean.com/company/blog/floating-ips-start-architecting-your-applications-for-high-availability/
          7. I can't really tell about logging user IPs. But you can also put the Node.js server directly on the machine or behind a proxy like Nginx. Rancher is a management platform.
          8. I don't understand.
          9. Research about how Git works, you can have a git repository in your server.
          10. https://www.digitalocean.com/community/search?q=mail&type=tutorials
          11. A quick search on Google will show several tools. Rancher doesn't exclude Nginx; you can have Nginx on Rancher.
          12. Containers simplify a lot of things, is like a very lightweight virtual machine. You don't need containers to deploy things unless you want to do it for convenience.
  • Hello,

    This looks like a great tutorial. I'm setting up my first VPS on DO and was considering a simple nginx server set up, possibly using it as a reverse proxy for apache as detailed here. I'll probably be doing mostly Node/Mongo projects but would like to have the option of running php/wordpress sites on there as well. I'd like to keep myself on a single 1gb droplet at least for now, but the ability to scale would be nice and your recipe would make that super easy. My only concern is that it seems like possible overkill for me at this point, would you say it's suitable for running a single instance/domain now with the intent to scale out as I add other sites? Also, as the @mhannan313 noted this set-up doesn't seem to include nginx or apache, would I want to add one of those? As you can probably tell I'm still a little new so I was just hoping to get your take on the best set up.

    Apache and Nginx are popular web servers, and you may find reasons to use both on the same server. This tutorial walks you through setting up web sites on Apache and Nginx and then proxying requests from Nginx on to Apache.
  • Actually, it looks like there's already another tutorial on DO about installing nginx in Docker. So I guess really my question could be shortened to, is it necessary/useful to use nginx in this context, or does the hapi server + Docker make that optional?

    by Thomas Taege
    This tutorial shows how to deploy Nginx in a Docker container. By containerizing Nginx, we cut down on our sysadmin overhead. We will no longer need to manage Nginx through a package manager or build it from source. The Docker container allows us to simply replace the whole container when a new version of Nginx is released. We only need to maintain the Nginx configuration file and our content.
    • If you have a Node.js application you don't need Apache or Nginx unless you plan to use a feature of those tools. However it is a common practice to put Nginx in front of a Node server to receive all the traffic, but in Rancher instead of Nginx we are using the included Load Balancer which is basically an UI for HAProxy; so you don't need to include Nginx either (again unless you need a Nginx specific feature).

      Also, the Rancher Load Balancer allows you to have several applications in the same server. The setup described in this article is enough for most cases.

      I hope that solves your questions.

      • Yes, that does - thanks!! Seems like a good excuse to get familiar with Docker. I would imagine it's possible to set up a separate container for LAMP applications, so I think I'll give this a shot. Thanks again for the comprehensive guide.

        • That's right, this method is pretty intuitive to get used to Docker. And yeah, you can put anything you want in Docker containers. You're welcome!

          • @jameskolce Hmm, I think I may have gone wrong at some point, or something was lost in translation. I had a pre-existing Droplet that I had set up with Ubuntu 16.04 and ssh access, and I was under the impression I could just set everything up to run on that one droplet. I got to Step 4 of this tutorial before I realized I had skipped the step of setting up Docker and Rancher on the droplet - no big deal, I was able to use the linked tutorial on setting up Rancher, and was able to add it to my existing Droplet rather than using the 1-click installation. I got Rancher set up but when you get to the end of the tutorial it has you launch a separate Droplet to use as a host... so now I have 2 droplets and looking ahead in this tutorial it looks like I'll need at least one more to run Mongo on. Is there a way to have everything run on one droplet (I definitely don't anticipate having the need for multiple droplets from a resource/traffic standpoint in the immediate future) or is that just not a use case this set up supports?

            Rancher supports Docker Machine-based provisioning, which makes it easy to create Docker hosts on cloud providers, or inside your own data center. In this tutorial, you'll use the DigitalOcean driver that's built into Rancher to create Droplets from the Rancher UI and provision them to run Docker compute hosts which you can monitor, scale, and use to deploy Docker containers.
          • @blakehschwartz You can have as many services on one server as long as it has enough resources, so there is no problem with having MongoDB on the same server. Although this tutorial had high availability in mind so is better to have the database in another one, that's easier to scale and more secure (high demand in the application won't affect the database directly in this way).

            I think it is also possible to put your projects in the same Rancher server (so you only need one droplet) although that's not recommended (in case it is possible) because if your application starts to get a lot of traffic and you need to scale, you might not be able to access to the Rancher Dashboard for example. If you still want to try do a quick research in Google, I think I saw a tutorial about it somewhere.

  • Hello,

    So, this is just my personal opinion but - as someone looking for a cheap/flexible way to run a VPS for personal projects and a couple of domains, I did not find Rancher to be a very good solution. If you don't mind paying for a handful of droplets the methods described here worked great (setting up server was a snap, and the pre-configured DO hosts were super easy to add - but will automatically launch extra droplets) - but I spent about a week trying to get everything set up to run on a single droplet and it was rather painful and in the end, once I did get a host running on the same droplet as the server it crashed the whole setup. I initially launched a DO pre-built host, and then deleted it once I realized I was going to be charged for an extra server - after which my Rancher server wouldn't recognize Custom hosts - I finally deleted the Rancher server after much troubleshooting and then was able to move forward. I can't say for sure I wasn't doing something wrong, but once the host/agent was up it never managed to get into a 'healthy' state, and was using all of my server's 1gb of memory plus a lot of cpu. After about 45 minutes it crashed and I wasn't able to access the dashboard/ui, or restart it through the command line on my server. I was following along with their Quick Start guide in which they have you launch multiple containers on a single machine, so it seemed possible but at the end of the day I just don't think this is a practical solution for a small set up. Also, their docs surprisingly fail to cover uninstalling Rancher, and I've not managed to get it or Docker completely off my machine (getting 'device or resource busy' errors that don't seem to be responding to what I can find on the internet.)

    I hate to cast aspersions on what looks like a really full-featured and well designed system, but I will be starting over with an nginx/apache setup.

    • That's a fair critique, I would agree that Rancher is best suited when you can spend some money for at least two droplets of 1GB and have a couple of services to run on it. For a smaller setup it would be better to do it directly on Docker or in the bare droplet.

      • Agreed - and I apologize for my knee-jerk reaction post. This certainly does seem like a great option if you need the ability to scale your app easily. Thanks for taking the time to do a well-organized, thorough, and easy to follow tutorial.

Creative Commons License