Feedback
Installation from Tarball Archive¶
This section of the documentation outlines how to use the release archives to install CrateDB. The walkthrough is suitable to install and run CrateDB on Unix-like systems, for example Linux and macOS.
Download the latest CrateDB release archive. Please make sure to select the right release archive matching your system.
Once downloaded, extract the archive either using your favorite terminal or command line shell or by using a GUI tool like 7-Zip:
# Extract tarball on Unix-like systems tar -xzf crate-*.tar.gz
On the terminal, change into the extracted
cratedirectory:cd crate-*
Run a CrateDB single-node instance on the local network interface:
./bin/crate
In order to stop CrateDB again, use ctrl-c.
See also
Consult the CLI tools documentation for further information
about the ./bin/crate command.
Post-install notes¶
After successfully installing CrateDB, for example on your workstation, the web-based Admin UI can be visited at:
http://localhost:4200/
See also
If you are new to CrateDB, you may want to follow up by taking the guided tour.
Also, let us outline those information entrypoints as suggestions to explore next:
Read more details about the Configuration.
The background about Bootstrap checks.
Multi-node configuration within the section about Clustering and Going into production.
When operating a CrateDB cluster in production, please also take performance tuning into consideration.
Note
This kind of installation flavor will let you quickly set up and start a single-node cluster. When adding additional CrateDB nodes, in order to make it form a multi-node cluster, you will need to reset (remove) the cluster state after changing the configuration.
Caution
Please make sure to read the General Upgrade Guidelines, and the guidelines about rolling upgrades and full restart upgrades, before upgrading a running cluster.