baseshift
Command-line client for Baseshift. Create dubs (masked or subsetted copies of a source database), take snapshots, and start clones for development and testing.
Install
pip install baseshift
Platform wheels ship for:
- macOS (Intel and Apple Silicon)
- Linux (
x86_64andarm64) - Windows (
amd64)
The default install talks to clones over WireGuard. For Tailscale, install the companion extra so both packages stay on the same version:
pip install 'baseshift[ts]'
Confirm the install:
baseshift --version
baseshift --help
Quick start
# Browser OAuth (default). Use --method=direct for email/password.
baseshift auth login
# Optional: write ~/.baseshift/config (org token and default dub)
baseshift init
# Create a cloud dub with demo data, or point at your own Postgres.
baseshift dub create --name my-dub --use-demo-db --encryption-password MyKey123
baseshift dub list
# Snapshot, then start a clone and print connection details.
baseshift snapshot create --dub my-dub --wait
baseshift server-clone start --dub my-dub
baseshift server-clone list --dub my-dub
baseshift server-clone stop
--dub accepts a name or a UUID. A name is resolved by the API; pass
--org-token (or set BASESHIFT_ORG_TOKEN / orgToken in config) when the
same name exists in more than one org. A UUID never needs --org-token.
dub create and dub list use your only organization when --org-token
is omitted. When you belong to more than one organization, pass
--org-token.
Commands
| Command | What it does |
|---|---|
auth |
Log in, log out, and check authentication status |
init |
Create ~/.baseshift/config with default org and dub |
dub |
Create and manage dubs (cloud or self-hosted Helm) |
data-env |
Create and manage data environments and their snapshots |
server-clone |
Start, stop, and list clones on Baseshift servers |
local-clone |
Pull or run a dub's snapshot image with local Docker |
snapshot |
Create, check, and list snapshots of a dub |
mcp |
Run the Baseshift MCP server on stdio |
Run baseshift <command> --help (and baseshift dub create -h) for flags.
Common dub actions: create, list, describe, status, health-check,
validate-values, configure-source, subset, masking.
Cloud dub against your database
baseshift dub create --name my-dub \
--hostname mydb.example.com --database acme --username app \
--password-stdin --encryption-password MyKey123
Self-hosted dub (Helm values)
baseshift dub create --deployment self-hosted --name my-onprem-dub \
--hostname mydb.example.com --database acme --username dubhub \
--password-stdin --registry-type none
baseshift dub validate-values --values-file values.yaml
Local Docker clone
baseshift local-clone pull --dub my-dub
baseshift local-clone run --dub my-dub -- --publish 5432:5432
Configuration
Values resolve as CLI flag → environment variable → ~/.baseshift/config → default.
baseshift init writes JSON to ~/.baseshift/config:
{
"orgToken": "<org-uuid>",
"dubUuid": "<dub-uuid>"
}
| Setting | Flag | Environment | Config key |
|---|---|---|---|
| Organization | --org-token |
BASESHIFT_ORG_TOKEN |
orgToken |
| Default dub | --dub / --dub-uuid |
BASESHIFT_DUB_UUID |
dubUuid |
Useful environment variables:
BASESHIFT_VERBOSE=1— DEBUG logs and full tracebacks (same as-v)BASESHIFT_DISABLE_SENTRY=1— disable error telemetryBASESHIFT_HELM_BIN— override the bundled Helm binary used bydub validate-values
MCP
baseshift mcp runs an MCP server on stdio (start/stop clones and related
tools). Log in with baseshift auth login first. Example Cursor config:
{
"mcpServers": {
"baseshift": {
"command": "baseshift",
"args": ["mcp"]
}
}
}
Links
- Product: baseshift.com
- App: app.baseshift.com
- PyPI: pypi.org/project/baseshift
License
BSD 2-Clause. See LICENSE, THIRD-PARTY-NOTICES, and
LICENSES-Apache-2.0-Helm.txt (bundled Helm).
1 maintainer
Metadata
1 maintainer
Release files for baseshift 3.5.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| baseshift-3.5.3-py3-none-win_amd64.whl | Python 3 | none | Windows x86-64 | Details |
| baseshift-3.5.3-py3-none-manylinux2014_x86_64.whl | Python 3 | none | Linux glibc 2.17+ x86-64 | Details |
| baseshift-3.5.3-py3-none-manylinux2014_aarch64.whl | Python 3 | none | Linux glibc 2.17+ ARM64 | Details |
| baseshift-3.5.3-py3-none-macosx_11_0_arm64.whl | Python 3 | none | macOS 11.0+ ARM64 | Details |
| baseshift-3.5.3-py3-none-macosx_10_9_x86_64.whl | Python 3 | none | macOS 10.9+ x86-64 | Details |
Total release size: 104.9 MB
Release files / baseshift-3.5.3-py3-none-win_amd64.whl
| Download URL | baseshift-3.5.3-py3-none-win_amd64.whl |
|---|---|
| Size | 21.6 MB |
| Tags | Python 3 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
a2d6fa34f56a41aca49ac553373786a2012a9cfcfa3c1608cd32f0304c0a42cd
|
|
BLAKE2b-256 checksum How to use checksums |
ed605cdc829ddc34711012699b57f3df71ed030995977f3addcfab26c14d0073
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.5
|
Release files / baseshift-3.5.3-py3-none-manylinux2014_x86_64.whl
| Download URL | baseshift-3.5.3-py3-none-manylinux2014_x86_64.whl |
|---|---|
| Size | 21.1 MB |
| Tags | Linux glibc 2.17+ x86-64 Python 3 |
|
SHA-256 checksum How to use checksums |
cef65ad0cad3ee0387b5039ca0404f4df2368f529281c9e16cc527b9dae08cfe
|
|
BLAKE2b-256 checksum How to use checksums |
94309b8718925d05504387b5a30c87f045e99994ef989946e0d2492f405f0b38
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.5
|
Release files / baseshift-3.5.3-py3-none-manylinux2014_aarch64.whl
| Download URL | baseshift-3.5.3-py3-none-manylinux2014_aarch64.whl |
|---|---|
| Size | 19.3 MB |
| Tags | Linux glibc 2.17+ ARM64 Python 3 |
|
SHA-256 checksum How to use checksums |
7447dbdb687c5e3650683e3e585e66878ad7363a180ab2b79cb8318093c070b3
|
|
BLAKE2b-256 checksum How to use checksums |
a420ff3e7c6971e221ce58acc6c2a99b3d91ea2bff68627676035c3982fd1ac5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.5
|
Release files / baseshift-3.5.3-py3-none-macosx_11_0_arm64.whl
| Download URL | baseshift-3.5.3-py3-none-macosx_11_0_arm64.whl |
|---|---|
| Size | 20.9 MB |
| Tags | Python 3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
ea5bfcfb602b6021d945d80fa2ca187eee64707451d369188e76e5771e8b2bec
|
|
BLAKE2b-256 checksum How to use checksums |
5638521e1bf810c6a72bc12850d2a79ba904983521e86d647f87e69a5102ba4c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.5
|
Release files / baseshift-3.5.3-py3-none-macosx_10_9_x86_64.whl
| Download URL | baseshift-3.5.3-py3-none-macosx_10_9_x86_64.whl |
|---|---|
| Size | 22.0 MB |
| Tags | Python 3 macOS 10.9+ x86-64 |
|
SHA-256 checksum How to use checksums |
1946288a5bac66bbd699456c56329f466c95ff43f45fd47e2e000a5bd1acb36d
|
|
BLAKE2b-256 checksum How to use checksums |
dd0ac5fea1f894f831e501abcbdcf358ea7d6d16ec448c3cee759e75d930ccf5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.5
|
