PHPackages                             fin-cli/core-command - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [CLI & Console](/categories/cli)
4. /
5. fin-cli/core-command

ActiveFin-cli-package[CLI & Console](/categories/cli)

fin-cli/core-command
====================

Downloads, installs, updates, and manages a FinPress installation.

v2.1.21(10mo ago)00MITPHPCI passing

Since Apr 18Pushed 8mo agoCompare

[ Source](https://github.com/fin-cli/core-command)[ Packagist](https://packagist.org/packages/fin-cli/core-command)[ Docs](https://github.com/wp-cli/core-command)[ RSS](/packages/fin-cli-core-command/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (7)Versions (59)Used By (0)

fin-cli/core-command
====================

[](#fin-clicore-command)

Downloads, installs, updates, and manages a FinPress installation.

[![Testing](https://github.com/fin-cli/core-command/actions/workflows/testing.yml/badge.svg)](https://github.com/fin-cli/core-command/actions/workflows/testing.yml)

Quick links: [Using](#using) | [Installing](#installing) | [Contributing](#contributing) | [Support](#support)

Using
-----

[](#using)

This package implements the following commands:

### fin core

[](#fin-core)

Downloads, installs, updates, and manages a FinPress installation.

```
fin core

```

**EXAMPLES**

```
# Download FinPress core
$ fin core download --locale=nl_NL
Downloading FinPress 4.5.2 (nl_NL)...
md5 hash verified: c5366d05b521831dd0b29dfc386e56a5
Success: FinPress downloaded.

# Install FinPress
$ fin core install --url=example.com --title=Example --admin_user=supervisor --admin_password=strongpassword --admin_email=info@example.com
Success: FinPress installed successfully.

# Display the FinPress version
$ fin core version
4.5.2

```

### fin core check-update

[](#fin-core-check-update)

Checks for FinPress updates via Version Check API.

```
fin core check-update [--minor] [--major] [--force-check] [--field=] [--fields=] [--format=]

```

Lists the most recent versions when there are updates available, or success message when up to date.

**OPTIONS**

```
[--minor]
	Compare only the first two parts of the version number.

[--major]
	Compare only the first part of the version number.

[--force-check]
	Bypass the transient cache and force a fresh update check.

[--field=]
	Prints the value of a single field for each update.

[--fields=]
	Limit the output to specific object fields. Defaults to version,update_type,package_url.

[--format=]
	Render output in a particular format.
	---
	default: table
	options:
	  - table
	  - csv
	  - count
	  - json
	  - yaml
	---

```

**EXAMPLES**

```
$ fin core check-update
+---------+-------------+-------------------------------------------------------------+
| version | update_type | package_url                                                 |
+---------+-------------+-------------------------------------------------------------+
| 4.5.2   | major       | https://downloads.finpress.org/release/finpress-4.5.2.zip |
+---------+-------------+-------------------------------------------------------------+

```

### fin core download

[](#fin-core-download)

Downloads core FinPress files.

```
fin core download [] [--path=] [--locale=] [--version=] [--skip-content] [--force] [--insecure] [--extract]

```

Downloads and extracts FinPress core files to the specified path. Uses current directory when no path is specified. Downloaded build is verified to have the correct md5 and then cached to the local filesystem. Subsequent uses of command will use the local cache if it still exists.

**OPTIONS**

```
[]
	Download directly from a provided URL instead of fetching the URL from the finpress.org servers.

[--path=]
	Specify the path in which to install FinPress. Defaults to current
	directory.

[--locale=]
	Select which language you want to download.

[--version=]
	Select which version you want to download. Accepts a version number, 'latest' or 'nightly'.

[--skip-content]
	Download FIN without the default themes and plugins.

[--force]
	Overwrites existing files, if present.

[--insecure]
	Retry download without certificate validation if TLS handshake fails. Note: This makes the request vulnerable to a MITM attack.

[--extract]
	Whether to extract the downloaded file. Defaults to true.

```

**EXAMPLES**

```
$ fin core download --locale=nl_NL
Downloading FinPress 4.5.2 (nl_NL)...
md5 hash verified: c5366d05b521831dd0b29dfc386e56a5
Success: FinPress downloaded.

```

### fin core install

[](#fin-core-install)

Runs the standard FinPress installation process.

```
fin core install --url= --title= --admin_user= [--admin_password=] --admin_email= [--locale=] [--skip-email]

```

Creates the FinPress tables in the database using the URL, title, and default admin user details provided. Performs the famous 5 minute install in seconds or less.

Note: if you've installed FinPress in a subdirectory, then you'll need to `fin option update siteurl` after `fin core install`. For instance, if FinPress is installed in the `/fin` directory and your domain is example.com, then you'll need to run `fin option update siteurl http://example.com/fin` for your FinPress installation to function properly.

Note: When using custom user tables (e.g. `CUSTOM_USER_TABLE`), the admin email and password are ignored if the user\_login already exists. If the user\_login doesn't exist, a new user will be created.

**OPTIONS**

```
--url=
	The address of the new site.

--title=
	The title of the new site.

--admin_user=
	The name of the admin user.

[--admin_password=]
	The password for the admin user. Defaults to randomly generated string.

--admin_email=
	The email address for the admin user.

[--locale=]
	The locale/language for the installation (e.g. `de_DE`). Default is `en_US`.

[--skip-email]
	Don't send an email notification to the new admin user.

```

**EXAMPLES**

```
# Install FinPress in 5 seconds
$ fin core install --url=example.com --title=Example --admin_user=supervisor --admin_password=strongpassword --admin_email=info@example.com
Success: FinPress installed successfully.

# Install FinPress without disclosing admin_password to bash history
$ fin core install --url=example.com --title=Example --admin_user=supervisor --admin_email=info@example.com --prompt=admin_password < admin_password.txt

```

### fin core is-installed

[](#fin-core-is-installed)

Checks if FinPress is installed.

```
fin core is-installed [--network]

```

Determines whether FinPress is installed by checking if the standard database tables are installed. Doesn't produce output; uses exit codes to communicate whether FinPress is installed.

**OPTIONS**

```
[--network]
	Check if this is a multisite installation.

```

**EXAMPLES**

```
# Bash script for checking if FinPress is not installed.

if ! fin core is-installed 2>/dev/null; then
    # FIN is not installed. Let's try installing it.
    fin core install
fi

# Bash script for checking if FinPress is installed, with fallback.

if fin core is-installed 2>/dev/null; then
    # FIN is installed. Let's do some things we should only do in a confirmed FIN environment.
    fin core verify-checksums
else
    # Fallback if FIN is not installed.
    echo 'Hey Friend, you are in the wrong spot. Move in to your FinPress directory and try again.'
fi

```

### fin core multisite-convert

[](#fin-core-multisite-convert)

Transforms an existing single-site installation into a multisite installation.

```
fin core multisite-convert [--title=] [--base=] [--subdomains] [--skip-config]

```

Creates the multisite database tables, and adds the multisite constants to fin-config.php.

For those using FinPress with Apache, remember to update the `.htaccess`file with the appropriate multisite rewrite rules.

[Review the multisite documentation](https://finpress.org/support/article/create-a-network/)for more details about how multisite works.

**OPTIONS**

```
[--title=]
	The title of the new network.

[--base=]
	Base path after the domain name that each site url will start with.
	---
	default: /
	---

[--subdomains]
	If passed, the network will use subdomains, instead of subdirectories. Doesn't work with 'localhost'.

[--skip-config]
	Don't add multisite constants to fin-config.php.

```

**EXAMPLES**

```
$ fin core multisite-convert
Set up multisite database tables.
Added multisite constants to fin-config.php.
Success: Network installed. Don't forget to set up rewrite rules.

```

### fin core multisite-install

[](#fin-core-multisite-install)

Installs FinPress multisite from scratch.

```
fin core multisite-install [--url=] [--base=] [--subdomains] --title= --admin_user= [--admin_password=] --admin_email= [--skip-email] [--skip-config]

```

Creates the FinPress tables in the database using the URL, title, and default admin user details provided. Then, creates the multisite tables in the database and adds multisite constants to the fin-config.php.

For those using FinPress with Apache, remember to update the `.htaccess`file with the appropriate multisite rewrite rules.

**OPTIONS**

```
[--url=]
	The address of the new site.

[--base=]
	Base path after the domain name that each site url in the network will start with.
	---
	default: /
	---

[--subdomains]
	If passed, the network will use subdomains, instead of subdirectories. Doesn't work with 'localhost'.

--title=
	The title of the new site.

--admin_user=
	The name of the admin user.
	---
	default: admin
	---

[--admin_password=]
	The password for the admin user. Defaults to randomly generated string.

--admin_email=
	The email address for the admin user.

[--skip-email]
	Don't send an email notification to the new admin user.

[--skip-config]
	Don't add multisite constants to fin-config.php.

```

**EXAMPLES**

```
$ fin core multisite-install --title="Welcome to the FinPress" \
> --admin_user="admin" --admin_password="password" \
> --admin_email="user@example.com"
Single site database tables already present.
Set up multisite database tables.
Added multisite constants to fin-config.php.
Success: Network installed. Don't forget to set up rewrite rules.

```

### fin core update

[](#fin-core-update)

Updates FinPress to a newer version.

```
fin core update [] [--minor] [--version=] [--force] [--locale=] [--insecure]

```

Defaults to updating FinPress to the latest version.

If you see "Error: Another update is currently in progress.", you may need to run `fin option delete core_updater.lock` after verifying another update isn't actually running.

**OPTIONS**

```
[]
	Path to zip file to use, instead of downloading from finpress.org.

[--minor]
	Only perform updates for minor releases (e.g. update from FIN 4.3 to 4.3.3 instead of 4.4.2).

[--version=]
	Update to a specific version, instead of to the latest version. Alternatively accepts 'nightly'.

[--force]
	Update even when installed FIN version is greater than the requested version.

[--locale=]
	Select which language you want to download.

[--insecure]
	Retry download without certificate validation if TLS handshake fails. Note: This makes the request vulnerable to a MITM attack.

```

**EXAMPLES**

```
# Update FinPress
$ fin core update
Updating to version 4.5.2 (en_US)...
Downloading update from https://downloads.finpress.org/release/finpress-4.5.2-no-content.zip...
Unpacking the update...
Cleaning up files...
No files found that need cleaning up
Success: FinPress updated successfully.

# Update FinPress using zip file.
$ fin core update ../latest.zip
Starting update...
Unpacking the update...
Success: FinPress updated successfully.

# Update FinPress to 3.1 forcefully
$ fin core update --version=3.1 --force
Updating to version 3.1 (en_US)...
Downloading update from https://finpress.org/finpress-3.1.zip...
Unpacking the update...
Warning: Checksums not available for FinPress 3.1/en_US. Please cleanup files manually.
Success: FinPress updated successfully.

```

### fin core update-db

[](#fin-core-update-db)

Runs the FinPress database update procedure.

```
fin core update-db [--network] [--dry-run]

```

**OPTIONS**

```
[--network]
	Update databases for all sites on a network

[--dry-run]
	Compare database versions without performing the update.

```

**EXAMPLES**

```
# Update the FinPress database.
$ fin core update-db
Success: FinPress database upgraded successfully from db version 36686 to 35700.

# Update databases for all sites on a network.
$ fin core update-db --network
FinPress database upgraded successfully from db version 35700 to 29630 on example.com/
Success: FinPress database upgraded on 123/123 sites.

```

### fin core version

[](#fin-core-version)

Displays the FinPress version.

```
fin core version [--extra]

```

**OPTIONS**

```
[--extra]
	Show extended version information.

```

**EXAMPLES**

```
# Display the FinPress version
$ fin core version
4.5.2

# Display FinPress version along with other information
$ fin core version --extra
FinPress version: 4.5.2
Database revision: 36686
TinyMCE version:   4.310 (4310-20160418)
Package language:  en_US

```

Installing
----------

[](#installing)

This package is included with FIN-CLI itself, no additional installation necessary.

To install the latest version of this package over what's included in FIN-CLI, run:

```
fin package install git@github.com:fin-cli/core-command.git

```

Contributing
------------

[](#contributing)

We appreciate you taking the initiative to contribute to this project.

Contributing isn’t limited to just code. We encourage you to contribute in the way that best fits your abilities, by writing tutorials, giving a demo at your local meetup, helping other users with their support questions, or revising our documentation.

For a more thorough introduction, [check out FIN-CLI's guide to contributing](https://make.finpress.org/cli/handbook/contributing/). This package follows those policy and guidelines.

### Reporting a bug

[](#reporting-a-bug)

Think you’ve found a bug? We’d love for you to help us get it fixed.

Before you create a new issue, you should [search existing issues](https://github.com/fin-cli/core-command/issues?q=label%3Abug%20) to see if there’s an existing resolution to it, or if it’s already been fixed in a newer version.

Once you’ve done a bit of searching and discovered there isn’t an open or fixed issue for your bug, please [create a new issue](https://github.com/fin-cli/core-command/issues/new). Include as much detail as you can, and clear steps to reproduce if possible. For more guidance, [review our bug report documentation](https://make.finpress.org/cli/handbook/bug-reports/).

### Creating a pull request

[](#creating-a-pull-request)

Want to contribute a new feature? Please first [open a new issue](https://github.com/fin-cli/core-command/issues/new) to discuss whether the feature is a good fit for the project.

Once you've decided to commit the time to seeing your pull request through, [please follow our guidelines for creating a pull request](https://make.finpress.org/cli/handbook/pull-requests/) to make sure it's a pleasant experience. See "[Setting up](https://make.finpress.org/cli/handbook/pull-requests/#setting-up)" for details specific to working on this package locally.

Support
-------

[](#support)

GitHub issues aren't for general support questions, but there are other venues you can try:

*This README.md is generated dynamically from the project's codebase using `fin scaffold package-readme` ([doc](https://github.com/fin-cli/scaffold-package-command#fin-scaffold-package-readme)). To suggest changes, please submit a pull request against the corresponding part of the codebase.*

###  Health Score

40

—

FairBetter than 88% of packages

Maintenance58

Moderate activity, may be stable

Popularity0

Limited adoption so far

Community19

Small or concentrated contributor base

Maturity77

Established project with proven stability

 Bus Factor1

Top contributor holds 51% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~62 days

Recently: every ~136 days

Total

49

Last Release

314d ago

Major Versions

v1.0.12 → v2.0.02018-08-05

### Community

Maintainers

![](https://www.gravatar.com/avatar/f263a779c82aff5af911e85cafc3450dbb0b4ed2386cc011731b24ab471eeeac?d=identicon)[dieselfox1](/maintainers/dieselfox1)

---

Top Contributors

[![danielbachhuber](https://avatars.githubusercontent.com/u/36432?v=4)](https://github.com/danielbachhuber "danielbachhuber (921 commits)")[![scribu](https://avatars.githubusercontent.com/u/225715?v=4)](https://github.com/scribu "scribu (315 commits)")[![schlessera](https://avatars.githubusercontent.com/u/83631?v=4)](https://github.com/schlessera "schlessera (225 commits)")[![gitlost](https://avatars.githubusercontent.com/u/481982?v=4)](https://github.com/gitlost "gitlost (47 commits)")[![swissspidy](https://avatars.githubusercontent.com/u/841956?v=4)](https://github.com/swissspidy "swissspidy (44 commits)")[![wojsmol](https://avatars.githubusercontent.com/u/4176111?v=4)](https://github.com/wojsmol "wojsmol (29 commits)")[![szepeviktor](https://avatars.githubusercontent.com/u/952007?v=4)](https://github.com/szepeviktor "szepeviktor (26 commits)")[![gilbitron](https://avatars.githubusercontent.com/u/203882?v=4)](https://github.com/gilbitron "gilbitron (21 commits)")[![rodrigoprimo](https://avatars.githubusercontent.com/u/77215?v=4)](https://github.com/rodrigoprimo "rodrigoprimo (19 commits)")[![miya0001](https://avatars.githubusercontent.com/u/309946?v=4)](https://github.com/miya0001 "miya0001 (17 commits)")[![ernilambar](https://avatars.githubusercontent.com/u/2098823?v=4)](https://github.com/ernilambar "ernilambar (17 commits)")[![nylen](https://avatars.githubusercontent.com/u/227022?v=4)](https://github.com/nylen "nylen (14 commits)")[![stephenharris](https://avatars.githubusercontent.com/u/3255034?v=4)](https://github.com/stephenharris "stephenharris (13 commits)")[![mbovel](https://avatars.githubusercontent.com/u/777748?v=4)](https://github.com/mbovel "mbovel (12 commits)")[![tlovett1](https://avatars.githubusercontent.com/u/1844351?v=4)](https://github.com/tlovett1 "tlovett1 (9 commits)")[![NateWr](https://avatars.githubusercontent.com/u/2306629?v=4)](https://github.com/NateWr "NateWr (8 commits)")[![mwilliamson](https://avatars.githubusercontent.com/u/391876?v=4)](https://github.com/mwilliamson "mwilliamson (7 commits)")[![francescolaffi](https://avatars.githubusercontent.com/u/357331?v=4)](https://github.com/francescolaffi "francescolaffi (6 commits)")[![dieselfox1](https://avatars.githubusercontent.com/u/39233575?v=4)](https://github.com/dieselfox1 "dieselfox1 (6 commits)")[![2ndkauboy](https://avatars.githubusercontent.com/u/1793177?v=4)](https://github.com/2ndkauboy "2ndkauboy (5 commits)")

### Embed Badge

![Health badge](/badges/fin-cli-core-command/health.svg)

```
[![Health](https://phpackages.com/badges/fin-cli-core-command/health.svg)](https://phpackages.com/packages/fin-cli-core-command)
```

###  Alternatives

[drush/drush

Drush is a command line shell and scripting interface for Drupal, a veritable Swiss Army knife designed to make life easier for those of us who spend some of our working hours hacking away at the command prompt.

2.4k57.4M685](/packages/drush-drush)[wp-cli/extension-command

Manages plugins and themes, including installs, activations, and updates.

919.0M53](/packages/wp-cli-extension-command)[wp-cli/core-command

Downloads, installs, updates, and manages a WordPress installation.

5110.2M23](/packages/wp-cli-core-command)[humbug/box

Fast, zero config application bundler with PHARs.

1.3k801.5k69](/packages/humbug-box)[wp-cli/entity-command

Manage WordPress comments, menus, options, posts, sites, terms, and users.

1048.8M55](/packages/wp-cli-entity-command)[wp-cli/scaffold-command

Generates code for post types, taxonomies, blocks, plugins, child themes, etc.

1717.7M15](/packages/wp-cli-scaffold-command)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)