MiniKF on AWS

Install MiniKF on GCP with the click of a button!

Installation instructions

1. Go to the MiniKF page on the AWS Marketplace

2. Click on the Continue to Subscribe button

MiniKF on AWS Markteplace

3. Click on the Accept Terms button

Accept Terms of MiniKF on the AWS Marketplace

4. Wait for a few minutes and the click on Continue to Configuration

MiniKF on AWS - Continue to Configuration

5. Select a Region. We recommend you keep the default values for Delivery Method and  Software Version. Then click Continue to Launch

Configure MiniKF on the AWS Marketplace

6. Here you can review your configuration details. Don’t forget to view the Usage Instructions and keep them handy, as you are going to need them later.

MiniKF on AWS - Configuration Details

7. You can also select how to launch MiniKF or change the EC2 instance type. We recommend you leave the default value for Choose Action. We recommend that you keep the default EC2 Instance Type (m5.2xlarge) or choose an even more powerful instance. Choosing a VM with reduced specs may make it impossible to train ML models.

MiniKF on AWS - Select Instance Type

8. Choose an existing VPC or create a new one. If you create a new one, make sure you click on the refresh icon to update the contents of the list, so that your new VPC appears in it.

Choose an existing VPC or create a new one - AWS

9. Choose an existing Subnet or create a new one. If you create a new one, make sure you click on the refresh icon to update the contents of the list, so that your new subnet appears in it.

Choose an existing subnet or create a new one - AWS

10. We strongly recommend to create a new security group. Otherwise you may not be able to access your MiniKF. To do so, click on Create New Based On Seller Settings

Note: If you need to use an existing security group, make sure it covers the ports mentioned in the usage instructions (see at the top of this page).

MiniKF on AWS - Create new security group

11. Choose an existing Key Pair or create a new one. If you create a new one, make sure you click on the refresh icon to update the contents of the list, so that your new key pair appears in it.

Choose an existing key pair or create a new one - AWS

12. Click Launch. You will then see a message informing you about the successful installation. The message contains a link to view the instance on the EC2 Console. Click on it.

MiniKF on AWS - Successful Deployment Message

13. You should now see a screen like this. Click on the Instance ID of the created instance

View your MiniKF instance on the EC2 Console

14. You will then see this page. Click Connect to connect to the instance using EC2 Instance Connect

Note: this will only work if you have created a security group based on seller settings, as in step 10, or you have configured a security group based on the usage instructions. Otherwise, you need to SSH to the instance manually, see: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/AccessingInstancesLinux.html

MiniKF on AWS - Connect to the instace

15. The User name will be prefilled. Click Connect

MiniKF on AWS - Connect using EC2 Instance Connect

16. Follow the on-screen instructions and type minikf to view the progress of the deployment

View deployment progress of MiniKF on AWS

17. Wait for a few minutes

Wait for MiniKF on AWS to complete the deployment process

18. Once the installation is completed you will see this screen

MiniKF on AWS - Provisioning completed

19. Follow the URL and log in to MiniKF using the provided username and password.

Note that MiniKF uses a self-signed certificate, so you will have to follow this guide to proceed to the MiniKF dashboard.

MiniKF on AWS - Provisioning completed

20. Once you log in, you will see the MiniKF Dashboard

MiniKF on AWS - Provisioning completed

Congratulations! You have successfully deployed MiniKF on AWS. You can now create notebooks, write your ML code, and run Kubeflow Pipelines.