See the v0.15.2 release notes for changes, upgrading, and compatibility notes.
Download the .msi installer from the release page.
💡 If Windows Defender SmartScreen says "it prevented an unrecognized app from starting" after downloading, you'll need to click "Run anyway".
Download the .pkg installer from the release page;
Or use Homebrew to install: brew install koordinates/kart/kart
For Debian/Ubuntu-based distributions, download the .deb package from the release page and install via dpkg -i kart_*.deb
.
For RPM-based distributions, download the .rpm package from the release page and install via rpm -i kart-*.rpm
.
For Kart development see the Contributing Notes.
See the documentation for tutorials and reference.
💡 If you're new to git
Configure the identity you will use for Kart commits with:
$ kart config --global user.email "you@example.com" $ kart config --global user.name "Your Name"
kx-foo-layer.gpkg
).
$ kart init myproject --import GPKG:kx-foo-layer.gpkg
$ cd myproject
Use this repository as the directory to run all the other commands in.
This will also create a working copy as myproject/myproject.gpkg
to edit.
kart
tableskart
.kart
commands should work if run from the myproject/
folder. Check --help
for options, the most important ones are supported. In some cases options are passed straight through to an underlying git command:
kart diff
diff the working copy against the repository (no index!)kart commit -m {message}
commit outstanding changes from the working copykart log
review commit historykart branch
& kart checkout -b
branch managementkart fetch
fetch upstream changes.kart status
show working copy state.kart merge
merge. Supports --ff
/--no-ff
/--ff-only
from one merge source.kart switch
switch to existing or new branches.kart reset
& kart restore
discard changes in the working copy.kart tag ...
kart remote ...
. Remember simple remotes can just be another local directory.kart push
/ kart pull
kart clone
initialise a new repository from a remote URL,This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License, version 2, as published by the Free Software Foundation.
In addition to the permissions in the GNU General Public License, the authors give you unlimited permission to link the compiled version of this file into combinations with other programs, and to distribute those combinations without any restriction coming from the use of this file. (The General Public License restrictions do apply in other respects; for example, they cover modification of the file, and distribution when not linked into a combined executable.)
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; see the file COPYING
. If not, write to
the Free Software Foundation, 51 Franklin Street, Fifth Floor,
Boston, MA 02110-1301, USA.