Pumpkin-Docs/docs/about/quick-start.md
Alexander Medvedev 530524b739 init
2024-12-22 19:45:25 +01:00

54 lines
1.4 KiB
Markdown

# Quick Start
**Current Status:**
Pre-release: Currently under development and not yet ready for official release.
To get Pumpkin running, you first have to clone it:
```shell
git clone https://github.com/Snowiiii/Pumpkin.git
cd Pumpkin
```
You may also have to [install rust](https://www.rust-lang.org/tools/install) if you don't already have it.
**Optional:**
You can place a vanilla world into the Pumpkin/ directory if you want. Just name the World `world`
Then run:
> [!NOTE]
> This can take a while because we enabled heavy optimizations for release builds
>
> To apply further optimizations specific to your CPU and use your CPU features, you should set the target-cpu=native
> Rust flag.
```shell
cargo run --release
```
## Docker
Experimental Docker support is available.
The image is currently not published anywhere, but you can use the following command to build and deploy it:
```shell
docker compose up --build
```
After running this command a `data/` folder should appear in which you'll be able to find all the server files.
Within this `data/` folder you can put your `world/` folder (make sure you restart the server)
## Test Server
Pumpkin has a Test server maintained by @kralverde. Its runs on the latest commit of Pumpkin
- **IP:** pumpkin.kralverde.dev
**Specs:**
- OS: Debian GNU/Linux bookworm 12.7 x86_64
- Kernel: Linux 6.1.0-21-cloud-amd64
- CPU: Intel Core (Haswell, no TSX) (2) @ 2.40 GHz
- RAM: 4GB DIMM