# Dependency injection or IOC

By default all the controllers are created by the auto-generated routes template using an empty default constructor. If you want to use dependency injection and let the DI-framework handle the creation of your controllers, we need set up an IoC Module tsoa can call.

To tell tsoa to use your DI-container you have to reference your module exporting the DI-container in the config file (e.g. tsoa.json):

  "entryFile": "...",
  "spec": {
  "routes": {
    "routesDir": "...",
    "middleware": "...",
    "iocModule": "src/ioc",


The convention is that you have to name your Container iocContainer and export it in the given module.


If you want to use another DI framework, adding it isn't hard. If you set an iocModule, tsoa will call this module (to get a FooController) with:

import { iocContainer } from "./the/path/to/the/module/from/tsoa.json";


If you wrap your DI's API or even a ControllerFactory to accept this call and respond with a FooController, it'll work.

# InversifyJS

Here is some example code to setup the container and your controller with inversify.js. Usually, you'll have to tell inversify how to create your controller, but since this is not supposed to cover inversify, we'll just refer to their docs. For convenience, we will use inversify-binding-controllers here, which makes it very simple to tell inversify how to create tsoa controllers. More information can be found here.

// src/ioc.ts
import { Container, decorate, injectable } from "inversify";
import { buildProviderModule } from "inversify-binding-decorators";
import { Controller } from "tsoa";

// Create a new container tsoa can use
const iocContainer = new Container();

decorate(injectable(), Controller); // Makes tsoa's Controller injectable

// make inversify aware of inversify-binding-decorators

// export according to convention
export { iocContainer };

We usually don't want to create a new controller instance for every call, so let's create a convenience wrapper around @fluentProvide()

// src/util/provideSingleton.ts
import { fluentProvide } from "inversify-binding-decorators";
import { interfaces } from "inversify";

export const provideSingleton = function <T>(
  identifier: interfaces.ServiceIdentifier<T>
) {
  return fluentProvide(identifier).inSingletonScope().done();

Now, in our controllers, we can use @provideSingleton()

// src/users/usersController.ts
import { Route } from 'tsoa';
import { provideSingleton, inject } from '../inversify/ioc';

export class UsersController {
    @inject(FooService) private fooService: FooService
  ) { }

@provideSingleton(FooService) // or @provide(FooService)
export class FooService {
    // maybe even more dependencies to be injected...

# typescript-ioc

Here is some example code to setup the controller with typescript-ioc.


import { Route } from 'tsoa';
import { Inject, Provides } from "typescript-ioc";

export class FooController {

  private fooService: FooService


export class FooService {


The controllers need to be included in the application in order to be linked.


import "./controllers/fooController.ts"