Skip to content
On this page


This section will help you to spin up Authup directly on the host system.


The following guide is based on some shared assumptions:

  • NodeJs v16 (minimum)
  • Min. 2 cores
  • Min. 5G hard disk
  • Up to two available ports (default: 3000 and 3001)

Step. 1: Create a new project

Create and change into a new directory.

$ mkdir authup && cd authup

Then, initialize with your preferred package manager.

$ npm init

Step. 2: Installation

Add this package as dependency to the project.

$ npm install authup --save

Step. 3: Configuration

Follow the instructions for configuring Authup using a configuration file or via environment variables. In case of a configuration file, place it in the root directory.

Step. 4: Boot up

Add some scripts to package.json.

  "scripts": {
      "start": "authup start"

The application setup will be processed on startup, if it has not already happened in a previous execution.

$ npm run start

The output should be similar to the following:

i Server: Starting... 
 Server: Started
i UI: Starting...
 UI: Started
i UI: Listening
i Server: Environment: production
i Server: WritableDirectoryPath: xxx
i Server: URL:
i Server: Docs-URL:
i Server: UI-URL:
i Server: Generating documentation...
i Server: Generated documentation.
i Server: Establishing database connection...
i Server: Established database connection.
i Server: Starting oauth2 cleaner...
i Server: Started oauth2 cleaner.
i Server: Starting http server...
i Server: Started http server.

Now all should be set up, and you are ready to go 🎉

This will lunch the following application with default settings:

  • UI:
  • API:
  • Docs: