Pushkin
  • Welcome!
  • Getting Started
    • Installing Pushkin and dependencies
      • macOS
      • Windows 10
        • Windows Subsystem for Linux
        • AWS EC2 Instance
      • Ubuntu Linux
    • Quickstart
      • Quickstart: Example Outputs
    • Deploying to AWS
      • Install required software.
      • Configure the AWS and ECS CLIs.
      • Register a domain.
      • Set up DockerHub.
      • Initialize AWS Deploy.
    • Tutorial: Simple Experiment
  • FAQ
    • FAQ
  • Advanced
    • Pushkin CLI
    • Using Experiment Templates
      • Lexical decision template
      • Grammaticality judgment template
      • Self-paced reading template
    • Experiment Component Structure
      • Experiment Config.yaml Files
      • Experiment Web Page Component
      • Worker Component, Migration, and Seed
    • Modifying Site Template
      • React Bootstrap
      • Header and Footer
      • Home Page
      • Findings Page
      • About Page
      • Feedback Page
    • Troubleshooting Pushkin
    • Pushkin Client
    • pushkin-api
      • API Controller Builder
      • Core API
    • Users & Authentication
    • Deployment
      • Deleting AWS
  • Developers
    • Developing with Pushkin
    • Getting Started on Development
    • Overview of Technologies
    • Testing Pushkin with Jest
    • Working with Templates
Powered by GitBook
On this page
  • Skip to section
  • Create your AWS EC2 instance
  • Connect to your EC2 instance
  • Managing your AWS instance
  • Next steps

Was this helpful?

  1. Getting Started
  2. Installing Pushkin and dependencies
  3. Windows 10

AWS EC2 Instance

PreviousWindows Subsystem for LinuxNextUbuntu Linux

Last updated 1 year ago

Was this helpful?

Previously we recommended that Windows users use Pushkin through an AWS EC2 instance due to bugs in WSL that made the setup unreliable. This issue seems to have been resolved, so we now recommend using WSL instead of an EC2 instance. Using an EC2 instance has a number of limitations, including:

  • You cannot do true local testing via localhost, as the IPv4 public IP address must be used.

  • In our experience, timeout errors are more common on EC2 instances.

  • If multiple experiments are installed, the EC2 instances may run out of space with the default amount of storage.

However, users can choose to create a free-tier instance for using and deploying Pushkin as an alternative to using WSL on Windows. In your instance, you will be able to run an Ubuntu virtual machine and follow the Ubuntu setup instructions. We suggest accessing this AWS EC2 instance from your local computer using the , though in principle any SSH client for Windows should work.

Skip to section

Create your AWS EC2 instance

Create your AWS Account

Go to and click Create a free account.

Complete the sign-up process and go to your inbox to confirm your email address.

Launch your EC2 Instance

Click on the Launch Instance button.

Scroll down to the Application and OS Images (Amazon Machine Image) and under the Quick Start tab and click on Ubuntu. The default selected should say Free tier eligible, but if it doesn't, click on the box and select a version that is free.

Now, scroll down to the Key pair (login) option, and on the bottom right, click on Create new key pair, create a new key pair and give it a name, (e.g., "pushkin-testing-key"), set it to RSA key type and change the private key format to .ppk. Make sure to dowload this file, keep it somewhere as this will be necessary to connect your instance later

Next, on the right of the Network settings heading, select Edit.

Select Add security group rule, under Type, choose HTTP in the drop-down menu. Then, select Add rule again and, under Type, select "HTTPS".

Now, click on Launch Instance.

Next, in the box that says "Your instances are now launching," click the instance ID, which will be an alphanumeric string.

This will take you to the AWS EC2 console. You should keep this window open.

Connect to your EC2 instance

In the Windows start menu, open PuTTY.

In the Category pane, choose Session.

In the Host Name box, enter "ubuntu@" followed by the public DNS of your instance.

The public DNS is found on the AWS EC2 console. One example is "ec2-18-191-193-31.us-east-2.compute.amazonaws.com". The 2- and 3-digit numbers will be different for each instance and "us-east-2" is based on what region you are in.

Ensure that the Port value is 22, the under Connection type select SSH.

In the Category pane, expand Connection, expand SSH, expand Auth, then choose Credentials.

Select the ".ppk" file you generated for your key pair and choose Open.

If you plan to start the session again later, you can save the session information. Under Category, choose Session, enter a name for the session in Saved Sessions, and then choose Save.

Note: When you stop running the AWS instance from the AWS console, on restart the IP address and the Public DNS will be different. If you save your settings in PuTTY, you will need to replace part of your host name with the new IP address. All other saved settings remain the same.

You can now choose Open to connect to your instance. PuTTY will display a security alert dialog box asking if you trust the host you are connecting to: choose Yes.

You are now connected to your instance! In the window that appears, run the following commands to update your Ubuntu EC2 instance:

 sudo apt update
 sudo apt upgrade

While upgrading, a box may come up that says the following:

A new version of /boot/grub/menu.lst is available, but the version installed currently has been locally modified.

Use the UP arrow key to select install the package maintainer's version and press ENTER to continue.

Managing your AWS instance

Remember to stop your instance

To avoid incurring charges on AWS's Free Tier, always shut down your AWS EC2 instance when you're done using it. To do this, go to the AWS EC2 console, right-click on your instance, expand Instance State, and select Stop. When a dialog box appears, click Yes, Stop.

How to restart your instance

To restart your instance, go to the AWS EC2 console, right-click on your instance, expand Instance State, and select Start.

Next steps

Head to the and, in the left sidebar, click Instances.

(For more on package management with apt, you can see the documentation . To learn more about the basics of the Linux command line, you can follow .)

From here, you can follow the instructions for to finish the installation.

AWS EC2 console
here
this tutorial
Ubuntu Linux
Amazon Web Services (AWS) EC2
PuTTY SSH client
Amazon Web Services
Create your AWS EC2 instance
Install and configure PuTTY
Connect to your EC2 instance
Managing your AWS instance
Next steps