Using CLI

​Installing CLI​
​Initialize a new TypeORM project​
​Create a new entity​
​Create a new subscriber​
​Create a new migration​
​Generate a migration from existing table schema​
​Run migrations​
​Revert migrations​
​Show migrations​
​Sync database schema​
​Log sync database schema queries without actual running them​
​Drop database schema​
​Run any SQL query​
​Clear cache​
​Check version​
Installing CLI
If entities files are in javascript
If you have a local typeorm version, make sure it matches the global version we are going to install.
Install typeorm globally with npm i -g typeorm. You can also choose to use npx typeorm <params> for each command if you prefer not having to install it.
If entities files are in typescript
This CLI tool is written in javascript and to be run on node. If your entity files are in typescript, you will need to transpile them to javascript before using CLI. You may skip this section if you only use javascript.
You may setup ts-node in your project to ease the operation as follows:
Install ts-node globally:
1
npm install -g ts-node
Copied!
Add typeorm command under scripts section in package.json
1
"scripts": {
2
    ...
3
    "typeorm": "node --require ts-node/register ./node_modules/typeorm/cli.js"
4
}
Copied!
If you want to load more modules like module-alias you can add more --require my-module-supporting-register
Then you may run the command like this:
1
npm run typeorm migration:run
Copied!
If you need to pass parameter with dash to npm script, you will need to add them after --. For example, if you need to generate, the command is like this:
1
npm run typeorm migration:generate -- -n migrationNameHere
Copied!
How to read the documentation
To reduce verbosity of the documentation, the following sections are using a globally installed typeorm CLI. Depending on how you installed the CLI, you may replace typeorm at the start of the command, by either npx typeorm or npm run typeorm.
Initialize a new TypeORM project
You can create a new project with everything already setup:
1
typeorm init
Copied!
It creates all files needed for a basic project with TypeORM:
.gitignore
package.json
README.md
tsconfig.json
ormconfig.json
src/entity/User.ts
src/index.ts
Then you can run npm install to install all dependencies. Once all dependencies are installed, you need to modify ormconfig.json and insert your own database settings. After that, you can run your application by running npm start.
All files are generated in the current directory. If you want to generate them in a special directory you can use --name:
1
typeorm init --name my-project
Copied!
To specify a specific database you use you can use --database:
1
typeorm init --database mssql
Copied!
You can also generate a base project with Express:
1
typeorm init --name my-project --express
Copied!
If you are using docker you can generate a docker-compose.yml file using:
1
typeorm init --docker
Copied!
typeorm init is the easiest and fastest way to setup a TypeORM project.
Create a new entity
You can create a new entity using CLI:
1
typeorm entity:create -n User
Copied!
where User is an entity file and class name. Running the command will create a new empty entity in entitiesDir of the project. To setup the entitiesDir of the project you must add it in connection options:
1
{
2
    cli: {
3
        entitiesDir: "src/entity"
4
    }
5
}
Copied!
Learn more about connection options. If you have a multi-module project structure with multiple entities in different directories you can provide the path to the CLI command where you want to generate an entity:
1
typeorm entity:create -n User -d src/user/entity
Copied!
Learn more about entities.
Create a new subscriber
You can create a new subscriber using CLI:
1
typeorm subscriber:create -n UserSubscriber
Copied!
where UserSubscriber is a subscriber file and class name. Running the following command will create a new empty subscriber in the subscribersDir of the project. To setup subscribersDir you must add it in connection options:
1
{
2
    cli: {
3
        subscribersDir: "src/subscriber"
4
    }
5
}
Copied!
Learn more about connection options. If you have a multi-module project structure with multiple subscribers in different directories you can provide a path to the CLI command where you want to generate a subscriber:
1
typeorm subscriber:create -n UserSubscriber -d src/user/subscriber
Copied!
Learn more about Subscribers.
Create a new migration
You can create a new migration using CLI:
1
typeorm migration:create -n UserMigration
Copied!
where UserMigration is a migration file and class name. Running the command will create a new empty migration in the migrationsDir of the project. To setup migrationsDir you must add it in connection options:
1
{
2
    cli: {
3
        migrationsDir: "src/migration"
4
    }
5
}
Copied!
Learn more about connection options. If you have a multi-module project structure with multiple migrations in different directories you can provide a path to the CLI command where you want to generate a migration:
1
typeorm migration:create -n UserMigration -d src/user/migration
Copied!
Learn more about Migrations.
Generate a migration from existing table schema
Automatic migration generation creates a new migration file and writes all sql queries that must be executed to update the database.
If no there were no changes generated, the command will exit with code 1.
1
typeorm migration:generate -n UserMigration
Copied!
The rule of thumb is to generate a migration after each entity change.
Learn more about Migrations.
Run migrations
To execute all pending migrations use following command:
1
typeorm migration:run
Copied!
Learn more about Migrations.
Revert migrations
To revert the most recently executed migration use the following command:
1
typeorm migration:revert
Copied!
This command will undo only the last executed migration. You can execute this command multiple times to revert multiple migrations. Learn more about Migrations.
Show migrations
To show all migrations and whether they've been run or not use following command:
1
typeorm migration:show
Copied!
[X] = Migration has been ran
[ ] = Migration is pending/unapplied
This command also returns an error code if there are unapplied migrations.
Sync database schema
To synchronize a database schema use:
1
typeorm schema:sync
Copied!
Be careful running this command in production - schema sync may cause data loss if you don't use it wisely. Check which sql queries it will run before running on production.
Log sync database schema queries without actual running them
To check what sql queries schema:sync is going to run use:
1
typeorm schema:log
Copied!
Drop database schema
To completely drop a database schema use:
1
typeorm schema:drop
Copied!
Be careful with this command on production since it completely removes data from your database.
Run any SQL query
You can execute any SQL query you want directly in the database using:
1
typeorm query "SELECT * FROM USERS"
Copied!
Clear cache
If you are using QueryBuilder caching, sometimes you may want to clear everything stored in the cache. You can do it using the following command:
1
typeorm cache:clear
Copied!
Check version
You can check what typeorm version you have installed (both local and global) by running:
1
typeorm version
Copied!