Koyeb Serverless Platform

Deploy an Apollo GraphQL Server with MongoDB Atlas on Koyeb
Learn more about Koyeb · Explore the documentation · Discover our tutorials

About Koyeb and the Apollo GraphQL Server with MongoDB Atlas example application

Koyeb is a developer-friendly serverless platform to deploy apps globally. No-ops, servers, or infrastructure management. This repository contains an Apollo GraphQL server you can deploy on the Koyeb serverless platform for testing.

This example application is designed to show how a GraphQL API using Apollo Server and MongoDB can be deployed on Koyeb.

Getting Started

Follow the steps below to deploy and run the Apollo GraphQL server with MongoDB Atlas on your Koyeb account.

Requirements

You need a Koyeb account to successfully deploy and run this application. If you don't already have an account, you can sign-up for free here.

Deploy using the Koyeb button

The fastest way to deploy the Apollo GraphQL server with MongoDB Atlas is to click the Deploy to Koyeb button below.

Clicking on this button brings you to the Koyeb App creation page with everything pre-set to launch this application.

To modify this application example, you will need to fork this repository. Checkout the fork and deploy instructions.

Fork and deploy to Koyeb

If you want to customize and enhance this application, you need to fork this repository.

If you used the Deploy to Koyeb button, you can simply link your service to your forked repository to be able to push changes. Alternatively, you can manually create the application as described below.

On the Koyeb Control Panel, on the Overview tab, click the Create Web Service button to begin.

1. Select GitHub as the deployment method.
2. In the repositories list, select the repository you just forked.
3. In the Environment variables section, click Add variable. Select the Secret type, enter MONGODB_URI as the key, and for the value, select Create Secret. Put MONGODB_URI as the name and then put the value to your MongoDB connection string. Read this tutorial for more information.
4. Click Add variable again and add a plaintext PORT variable set to 8080.
5. Choose a name for your App and Service, i.e graphql-api-on-koyeb, and click Deploy.

You land on the deployment page where you can follow the build of your application. Once the build is completed, your application is being deployed and you will be able to access it via <YOUR_APP_NAME>-<YOUR_ORG_NAME>.koyeb.app.

Contributing

If you have any questions, ideas or suggestions regarding this application sample, feel free to open an issue or fork this repository and open a pull request.

Contact

Koyeb - @gokoyeb - Slack