This example application shows how to create a Node.js Express web app using TypeScript. Please read Use TypeScript to Build a Node API with Express to see how this app was created.
- Install Node.js version 8+
- Install Docker (or some other instance of PostgreSQL)
- Clone or download this repository
- Install modules using
npm install
- Copy
.env.sample
to.env
- Set up PostgreSQL with Docker. With docker installed, use the following two commands to create an instance of PostgreSQL for the application. Feel free to change the name and password for the database.
docker pull postgres:latest
docker run -d --name guitar-db -p 5432:5432 -e 'POSTGRES_PASSWORD=p@ssw0rd42' postgres
-
Modify
.env
to match your PostgreSQL server connection and credentials -
Initialize the PostgreSQL database by running
npm run initdb
-
Create a free Okta Developer Account
-
Set up a new Okta application
- Click Applications in the top menu and then click "Add Application"
- Click "Web" and click Next
- Name your application, and verify the Base and Login URIs are correct. By default, the web application will run locally at http://localhost:8080. Click Done.
-
On the Application screen under the General tab you will find a section for "Client Credentials." You will need to copy the values for "Client ID" and "Client secret" and paste them into the
.env
file forOKTA_CLIENT_ID
andOKTA_CLIENT_SECRET
, respectively. -
Copy the URL for your Okta developer account (e.g.
https://dev-123456-admin.oktapreview.com
) and paste it into the.env
file as the value forOKTA_ORG_URL
. Remove-admin
from the URL. The setting should look similar to:
OKTA_ORG_URL=https://dev-123456.oktapreview.com
To run the application in development mode:
npm run dev
By default, the web application should now be running at http://localhost:8080.
This example application uses:
Please post any questions as comments on the blog post, or visit our Okta Developer Forums. You can also email [email protected] if you would like to create a support ticket.
Apache 2.0, see LICENSE.